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Introduction 



•n,e C+O Reference Manual provides a c^f j3^.|'^Pf^",°^,tlS!^°,{,^tlon. 
funcUons provided in the class Ubr^y. ™« ' th"^'''ius reS 
S;S^t.tt^^Seaefe«™u1l^'ma^^^ to learn the 



specifics of a particular function. 



Class Inheritance Diagram 



C+0 Class Library 




Class Inheritance Diagram 



^BLK^ ^^A^ ^MC^ ^MEM^ ^MMS^ ^MSG^ ^STR^ ^SK^ 



Primitive Classes 



Superclass Server 



Subclass ( Y ) Client 
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two times 
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Y Inherits From X 



Y Inherits From X 
Twice 
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Function Name 



Description 



Page Scope Macro 



BIkClear 

BIkDelnit 

BIkExecute 

BIkExecuteRetBool 

BIkExecuteRetDataPtr 

BlkExecuteRetFuncPtr 

BIkExecuteRetInt 

BIkHasMethod 

Bikini! 

BIkPrint 

BlkPushDataPtr 

BlkPushFuncPlr 

BIkPushLargeInt 

BIkPushMediumInt 

BlkSetMethod 



Clear instance 

Deinitialize instance 

Execute mettiod with parameters 

Execute the method, return int 

Execute method, return mem pointer 

Execute method, return function ptr 

Execute method, return int 

Return True if instance has non-NULL method 

Initialize instance 

Print contents of instance 

Save pointer parameter 

Save functton pointer parameter. 

Save Largeint parameter 

Save Mediumint parameter 

Set the function to can 



Blk-2 

Blk-3 

Blk-4 

Blk-5 

Blk-6 

Blk-7 

Blk-8 

Blk-9 

BIk - 10 

Blk-11 

BIk -12 

BIk -13 

BIk '14 

BIk -15 

BIk -16 



Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Publte 
Public 



CIsCreateMessages 

CIsCreateObject 

CIsCreateSupers 

CIsDelnit 

CIsOestroy 

CIsDestroyMessages 

CIsDestroyObject 

ClsOestroySuperClasses 

CIsRndMsg 

CIsFindSelectorlndex 

CIsFindSuperClass 

CisGetMessageCount 

CIsGetMethodAndOffset 

CIsGetName 

CIsGetNthMsg 

CIsGetNthSuperClass 

CIsGetObjectSize 

CIsGetOffsetForMsg 

CIsGetOtfsetOfNthSuper 

CIsGetRootSubClass 

CIsGetRootSubObjectOffset 

ClsGetF\ootSubObjectSlze 

CIsGetSize 

CIsGetSubClass 

CIsGetSubObjectOffset 



Create the Msg instances 


N/A 




Undoc 


N 


Create a new Object instance 


CIS- 


2 


Public 


N 


Create the superclass instances 


N/A 




Undoc 


N 


Deinitialize the instance 


Cls- 


3 


Public 


N 


Deallocate the instance 


CIs- 


4 


Public 


N 


Destroy the messages 


N/A 




Undoc 


N 


Deallocate the object instance 


ClS- 


5 


Public 


N 


Destroy the superclasses 


N/A 




Undoc 


N 


Find message given selector name 


CIS- 


7 


Public 


N 


Find index of selector given name 


CIS- 


8 


Public 


N 


Find superclass given name 


CIs- 


10 


Public 


N 


Get number of messages 


Cls- 


11 


Public 


N 


Return method and sub/super offset 


Cls- 


12 


Public 


N 


Return name of the instance 


CIS- 


14 


Public 


N 


Get pointer to nth Message 


CIS- 


15 


Public 


N 


Get pointer to Nth superclass 


CIS- 


16 


Public 


N 


Return size of an object instance 


CIS- 


•17 


Public 


N 


Return sub/super offset of object 


Cls- 


•18 


Public 


N 


Return offset of nth superot)ject 


as- 


20 


Public 


N 


Get the root subclass 


CIs 


•22 


Public 


N 


Return offset of root subobject 


CIS 


■23 


Public 


N 


Return size of the root subobject 


CIS 


■24 


Public 


N 


Return size of the instance 


CIS 


■25 


Public 


N 


Return subclass 


CIS 


-26 


Public 


N 


Return offset of a subobject 


CIS 


■27 


Public 


N 



Hi 
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Function Name Description Page Scope Macro 



CIsGetSuperClassCount 


Return number of superclasses 


as* 


28 


Public 


-1 

N 


CIsGetSuperClasslndex 


Return superclass index 


CIS- 


29 


Public 


N 


CIslnit 


Initialize the instance 


CIS- 


30 


Public 


N 


CIsisRoot 


Is instance the root subclass? 


CIS- 


31 


Public 


N 


CIsOffsetSupers 


Offset superclasses from subclass. 


N/A 




Undoc 


N 


CIsPrint 


Print the instance 


CIs- 


32 


Public 


N 


CIsSendDestroy 


Send destroy message to instance 


CIs- 


33 


Public 


N 


CIsSendObjectMessage 


Send object a message 


CIS- 


34 


Public 


N 


CIsSendObjectMessageRetumInt 


Send object message, returns Mediumint 


CIs- 


36 


Public 


N 


CIsSendObjectMessageRetumPtr 


Send object message, returns Void * 


Qs- 


38 


Public 


N 


CIsSuperClassOf 


Initialize sub/super relation 






Undoc 


N 



OIIAppend 


Append element to list 


Dll 


•2 


Public 


N 


DIIAppendLast 


Make element last 


Oil 


•4 


Public 


Y 


DIIAsObj 


Return listasotiject 


Dll 


•6 


Private 


Y 


DUCIear 


Clear the list 


Dll 


■7 


Public 


N 


DHCut 


Cut one element from list 


Dll 


-8 


Public 


N 


OllCutChildren 


Cut all elements from list 


Dll 


•10 


Public 


N 


OUCutRange 


Cut element(s) from list 


Dll 


■11 


Public 


N 


OHDelnit 


Deinitiaiize list object 


Dll 


•13 


Public 


N 


DllOestroy 


Deinitialize list object and free space 


Dll 


•14 


Publk: 


N 


DIIGetClient 


Return client of list 


Dll 


■15 


Public 


Y 


DyGetRrst 


Return first element 


Dll 


■16 


Private 


Y 


OIIGetLast 


Return last element 


Dll 


-17 


Private 


Y 


DUGetNth 


Return Ntti element 


Dll 


•18 


Private 


N 


OflGetSize 


Get size of list 


Dll 


-19 


Public 


N 


Dlllnit 


Initialize list object 


Dll 


■20 


Public 


N 


DUInsert 


Insert element in list 


Dll 


•21 


Public 


N 


DninsertFirst 


Make element first 


Dll- 


23 


Public 


Y 


DlllsEmpty 


Return True if list empty 


Dll- 


•25 


Public 


Y 


OIILelClientCount 


Visit function: count elements conditionally 


Dll 


-26 


Public 


N 


OflLelClientRnd 


Visit searcli function: all elements 


Dll 


■28 


Public 


N 


DiiLelClientRrst 


Return client of first element 


Dll- 


•30 


Public 


Y 


DIILelClientGetNth 


Return Nth client 


Dll- 


•31 


Public 


N 


DIILelClientLast 


Return client of last element 


Dll- 


•33 


Public 


Y 


DIILelClientVisitBwd 


Visit function: all elements 


Dll- 


•34 


Public 


N 


OIILelClientVisitFwd 


Visit function: all elements 


Dll- 


•36 


Public 


N 


DilNobfyCutRange 


Cut elements 


Dll- 


38 


Friend 


N 


OIINodfyPasteRange 


Paste elements 


Dll- 


39 


Friend 


N 


DIIPasteRangeAfter 


Paste element(s) to list 


Dll- 


40 


Public 


N 


DIIPasteRangeBefore 


Paste element(s) in list 


Dll- 


42 


Public 


N 


DIIPasteRangeRrst 


Paste elementjs) to be first in list 


Dll- 


44 


Pubfic 


Y 


DIIPasteRangeLast 


Paste element(s) to end of list 


Dll- 


46 


Public 


Y 


OllSendOestroy 


Send message for list destruction 


Dll- 


48 


Public 


N 
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Function Name 



Descilptlon 





Page 


Scope M 


lacro 




Dpa-2 


Public 


N 




Dpa-4 


Public 


N 




Dpa-5 


Public 


N 




Dpa-7 


Public 


N 




Dpa-9 


Public 


N 




Dpa-10 


Public 


N 




Dpa-12 


Public 


N 




Dpa-13 


Public 


N 




Dpa-15 


Public 


N 




Dpa-17 


Public 


N 




Dpa-19 


Public 


N 




Dpa-21 


Public 


N 




Dpa*23 


Public 


N 




Dpa-27 


Public 


N 




Dpa-25 


Public 


N 




Dpa-29 


Public 


N 




Dpa-31 


Public 


N 




N/A 


Undoc 


N 




N/A 


Undoc 


N 




Dpa-33 


Public 


N 




Dpa-35 


Public 


N 




Dpa-37 


Public 


N 




Dpa-38 


Public 


N 




Dpa-40 


Public 


N 




0133-42 


Public 


N 




Dpa-44 


Public 


N 




Dpa-46 


Public 


N 




Dpa-48 


Public 


N 




Dpa-50 


Public 


N 



DpaAppend 

DpaClear 

DpaCount 

DpaCountRange 

OpaDelnit 



DpaOestroy 

DpaExpand 

DpaRnd 

DpaRndPtrBwd 

DpaRndPlrFwd 

DpaRndRangeBwd 

DpaRndRangeFwd 

DpaGetLast 

DpaGetNth 

DpaGetSize 

Dpalnit 

DpaNewArray 

DpaResize 

DpaSetNth 

DpaSetRegionNull 

DpaSetSize 

DpaShiftDown 

DpaShiftUp 

DpaVisit 

DpaVisitClient 

DpaVisitRange 

DpaVisitRegion 

DpaVisitSelfAndSuccessors 



Append an element 

Clear dynamic array 

Visit function: count Toje returns 

Visit function: range wilfi return ctieclcing 

Deinltialize tfie dynamic array otqect 

Delete element(s) 

Deinitialize array object and free space 
Paste Null element(s) into array 
Rnd index returning True 
Rnd index with matching pointer 
Rnd index with matching pointer 
Rnd index returning True for range 
Rnd index returning True for range 
Return last element in array 
Return Nth aray element 
Return number of elements 
Initialize the edge ot}ject 
Create a new array 
Resize the array 
Set Nth element of array 
Make region of elements Null 
Set array size to N elements 
Shift down N elements in array 
Shift up N elements in array 
Visit function: all elements 
Visit function: all elements 
Visit function: range of elements 
Visit function: region of elements 
Visit function: client and successors 



EdgAsGrfLel 

EdgAslnLel 

EdgAsObj 

EdgAsOutLel 

EdgClear 

EdgComparelnVtx 

EdgConnectToGrf 

EdgConnectToVertices 

EdgDelnit 

EdgDestroy 

EdgDisconnectFromGrf 

EdgDisconnectFromVertices 



Return graph list element for edge 
Return incoming edge list element 
Return edge as otqect 
Return outgoing edge list element 
Clear the edge 
Compare incoming vertex 
Connect edge to graph 
Connect edge to vertices 
Deinitialize the edge object 
Deinitialize edge object and free space 
Disconnect edge from graph 
Disconnect edge from vertices 



Edg-2 

Edg-3 

Edg-4 

Edg-5 

Edg-6 

Edg-7 

Edg-9 

Edg-11 

Edg-ia 

Edg-14 

Edg-15 

Edg-17 



Friend 
Friend 
Private 
Friend 
Public 
Public 
Public 
Public 
Public 
Public 
Public 
Public 



V 
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Function Name 



Description 



Page Scope Macro 



EdgGetClient 

EdgGetGrf 

EdgGetlnVtx 

EdgGetNextIn 

EdgGetNextOut 

EdgGetOutVtx 

EdgGetVertices 

EdgHasVertices 

EdglnGrf 

Edglnit 

EdgSendDestroy 
EdgUpdatelnVtx 
EdgUpdateOutVtx 



Return client of edge 
Return graph 
Return incoming vertex 
Return next incoming edge 
Return next outgoing edge 
Return outgoing vertex 
Return vertices to edge 
Does edge have any vertices 
Is edge in graph 
Initialize the edge object 
Send message for edge destmction 
Replace incoming vertex 
Replace outgoing vertex 



Edg-19 
Edg-20 
Edg-21 
Edg-23 
Edg-25 
Edg-27 
Edg-29 
Edg-31 
Edg-32 
Edg-33 
Edg-34 
Edg-35 
Edg-37 



Public 
Friend 
Friend 
Friend 
Friend 
Friend 
Public 
Public 
Public 
Public 
Public 
Public 
Public 



Y" 

Y 

Y 

Y 

Y 

Y 

Y 

N 

Y 

N 

Y 

N 

N 



GrfAnyCydes 
GrfAsEdgDII 
GrtAsObj 
GrfAsVtxDII 

GrfBasicTopologicalSort 

GrfClear 

GrfCountEdg 

GrfCJountVtx 

GrfOelnit 

GrfDestroy 

GrfDoTopologicalSoft 

GrfRndEdgaient 

GrfFindVtxClient 

GrfGetClient 

Grflnit 

GrfSendDestroy 

GrfVisitEdgaient 

GrfVisitVtxClient 

GrfVisitVtxClientlnTopOrderBwd 

GrfVisitVtxClientlnTopOrderFwd 



Check graph for cycles 

Return Ust of edges 

Return graph as object 

Return Ust of vertices 

Do topological sort of graph 

Clear the graph 

Count edges of graph 

Count vertices of graph 

Deinitialize Graph object 

Deinitiaiize Graph object and free space 

Do topological sort of graph 

Visit search function: edges 

Visit search function: vertices 

Return client of graph 

Initialize Graph object 

Send message for graph destoiction 

Visit function: edges 

Visit function: vertices 

Visit function: backward topological order 

Visit function: fonA^ard topological order 



Grf-2 

Grf.4 

Gff-5 

Grf-6 

N/A 

Grf-7 

Grf-a 

Grf-10 

Gf1-12 

Grf-13 

Grf-14 

Grf-16 

Grf-18 

Grf-20 

Grf-21 

Grf-22 

Grf-23 

Grf-25 

Grf-27 

Grf-29 



Public 

Friend 

Private 

Friend 

Undoc 

Public 

Public 

Public 

Publfc 

Public 

Public 

Public 

Public 

Public 

Public 

Public 

Public 

Public 

Public 

Public 



Y 
N 
N 
N 
N 
N 
Y 
Y 
N 
N 
Y 
N 
N 
N 
N 
N 
N 
N 
N 
N 



JulAddDays 

JulAddDaysL 

JulAddMonths 

JulAddQuarters 

JulAddYears 

JulCalendarToJulian 



Add/subtract days to date 
Add/subtract days to date (long) 
Add/subtract months to date 
Add/subtract quarters to date 
Add/subtract years to date 
Day, month, year to julian day 



Jul -2 
Jul -4 
Jul -6 
Jul -8 
Jul - 10 
JuM2 



Public 
Public 
Public 
Public 
Public 
Public 
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Function Name Description Page Scope iMacro 



JulCopy 


Copy julian day 


Jul 


• 14 


Public 


Y 


JulDateStrToJulian 


Date string to julian day 


Jul 


■16 


Public 


N 


JulDayOfWeek 


Day number in week 


Jul 


-18 


Public 


Y 


JulDayOfYear 


Day number in year 


Jul 


•20 


Publk: 


N 


JulDayslnMonth 


Days in month 


Jul 


■22 


Publte 


N 


JulDayslnQuarter 


Days in quarter 


Jul' 


■24 


Publfc 


N 


JulDayslnYear 


Days in year 


Jul 


■26 


Public 


N 


JulDiff 


Days between two dates 


Jul 


■28 


Public 


Y 


JulDiffL 


Days between two dates (long) 


Jul 


■30 


Public 


Y 


JulGetSystemJulianDay 


System date as julian day 


Jul 


■32 


Public 


N 


Jullnit 


Set to beginning of calendar January 1, 1583 


Jul 


■34 


Public 


Y 


JullsLeapYear 


Is date in leap year 


Jul 


•36 


Public 


N 


JullsMaxValue 


Is date maximum julian value 


Jul' 


-38 


Public 


Y 


JulMax 


The maximum of two julian dates 


Jul 


•40 


Public 


Y 


JulMin 


The minimum of two julian dates 


Jul' 


■42 


Public 


Y 


JulMonthDayDiff 


Days between date and a day/month 


Jul' 


■44 


Public 


N 


JulMonthString 


Rll string with month and year 


Jul' 


•46 


Public 


N 


JulQuarterString 


Rll string with quarter and year 


Jul' 


■48 


Public 


N 


JulSameDayMonth 


Two dates same day and month 


Jul' 


•50 


Public 


N 


JulSetMaxDate 


Set date to maximum value 


Jul 


■52 


Public 


N 


JulToCalendar 


Julian day to day, month, year 


Jul 


■54 


Public 


N 


JulToDateStr 


Rll date string of specified format 


Jut 


■56 


Public 


N 


JulValidateOate 


Validate date passed as string 


Jut 


■58 


Publk: 


N 


JulWeekString 


Rll string with day and month 


Jul 


■60 


Public 


N 


JutYearString 


Rll string with year 


Jul' 


■62 


Public 


N 



LelAsOi^ 


Return element as object 


1^1-2 


Private 


Y 


LeICIientCount 


Return count for client and successors 


Lei -3 


Public 


N 


LeiaientDH 


Return client of list 


Lei -5 


Public 


Y 


LeICIientFtndRange 


Visit search function: range 


Lei -6 


Public 


N 


LeICIientNext 


Return client of next element 


Lei -8 


Public 


Y 


LelQIentPrev 


Return client of previous element 


Lei -9 


Public 


Y 


LeICIIentVlsitBwd 


Visit function: client and predecessors 


Lei - 10 


Public 


N 


LeICIientVisitFwd 


Visit function: client and successors 


Lei -12 


Public 


N 


LelQientVisitPredecessors 


Visit function: predecessors 


Lei - 14 


Public 


N 


LelQientVisitRange 


Visit function: range 


Lei - 16 


Public 


N 


LelClientVisitSuccessors 


Visit function: successors 


Let - 18 


Public 


N 


LeICountRange 


Count elements 


Lei -20 


Public 


N 


LeICut 


Cut element from list 


Lei -22 


Public 


N 


LeICutRange 


Cut element(s) from list 


Lei -24 


Public 


N 


LelCutRangeFromUst 


Cut elementjs) from list 


N/A 


Undoc 


N 


LeIDelnIt 


Oeinitialize list element object 


Lei -26 


Public 


N 
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Function Name Description Page Scope Macro 



ObjSendMessage 


Send message to object 


Obj-21 


Public 


N 


ObjSendMessageRetumInt 


Send message to object, return Int 


Obj-22 


Public 


N 


ObjSendA4essageRetumPtr 


Send message to object, return pointer 


Obj-23 


Public 


N 



StrBask£xtract 


Extract a string 


N/A 


Undoc 


N 


StrExtract 


Extract string as specified 


Str-2 


Public 


N 


StrFromDate 


Rll string with a date 


Str-4 


Public 


N 


StrFromMediumInt 


integer to string 


Slr-6 


Public 


N 


Strlnit 


Init string to zero 


Str-8 


Public 


Y 


StrReplaceSubStr 


Replace sub-string in string 


Str-9 


Public 


N 


StrSet 


Copy string to another 


Str-11 


Public 


Y 


StrSqueeze 


Removes any character from string 


Str-13 


Public 


N 


StrToDate 


Parse a date string for year, month, day 


Str-15 


Public 


N 


StrToLower 


Change case of string to tower 


Str-17 


Public 


Y 


StrToMediumInt 


String to integer 


Str-19 


Public 


N 


StrToUpper 


Change case of string to upper 


Str-21 


Public 


Y 



TreAsDII 


Return node as list 


Tre-2 


Private 


Y 


TreAsLel 


Return node as list element 


Tre-3 


Private 


Y 


TreAsObj 


Return node as object 


Tre-4 


Private 


Y 


TreClear 


Clear the tree 


Tre-5 


Public 


N 


TreClient 


Return client of node 


Tre-6 


Public 


Y 


TreClientFindChild 


Visit search function: children 


Tre-7 


Public 


N 


TreClientRrstChild 


Return first child node as client 


Tre-9 


Public 


Y 


TreClientLastChild 


Return last child node as client 


Tre-11 


Public 


Y 


TreClientLastLeaf 


Return last leaf node as client 


Tre-iS 


Public 


Y 


TreClientNext 


Return next node as client 


Tre-15 


Public 


Y 


TreClientNextPreOrder 


Return next PreOrder client node 


Tre-17 


Public 


Y 


TreClientNextUncle 


Return next uncle as client 


Tre-19 


Public 


Y 


TreClientParent 


Return parent node 


Tre-21 


Public 


Y 


TreClientPrev 


Return prev client 


Tre-23 


Public 


Y 


TreClientPrevPreOrder 


Return previous client PreOrderly 


Tre-25 


Public 


Y 


TreClientVisitBranchlnOrder 


Visit function: branch in-order 


Tre-27 


Public 


N 


TreClientVisitChildren 


Visit function: all children 


Tre-29 


Public 


N 


TreClientVisitChildrenBwd 


Visit function: all children 


Tre-31 


Public 


N 


TreClientVlsitDescBranchlnOrder 


Visit function: descendents 


Tre-33 


Public 


N 


TreClientVisilDesclnOrder 


Visit function: descendents 


Tre-35 


Public 


N 


TreClientVisitDesclnOrderBwd 


Visit function: descendents 


Tre-37 


Public 


N 


TreClientVisitDescLeaves 


Visit function: descendents 


Tre-39 


Private 


N 


TreClientVisitDescPreOrder 


Visit function: descendents 


Tre-41 


Public 


N 


TreClientVisitlnOrder 


Visit function: in-order 


Tre-43 


Public 


N 


TreClientVisitlnOrderBwd 


Visit function: in-order 


Tre-45 


Public 


N 



X 
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TreClientVlsltLeaves 


visii TunciiOn. loaves 


Tre- 


47 


Public 


N 


TreClientVisitParents 


Visit function, nearest parenis iirsi 


Tro - 

1 IC 


Ha 


Pi ihlir 




TreClientVisitPreOrder 


Visit luncuon. pre-oroer 


TfA - 


W 1 


Pi thlir* 


N 
1^ 


TreClientVisitRange 


Visit function, range 






Public 


N 


TreClientVisitSuccPreOrder 


Visit function: all successors 


ire - 


30 


rUDIIC 


M 
IM 


TreClientVisitSuccessors 


Visit function: successors 


ire " 


K7 
0/ 


Pi iKli/« 


M 
l>i 


TreCutChikjren 


Cut children from tree 


ire - 




DiiKlw* 
rUullC 


V 
T 


TreCutRange 


Cut node(s) from tree 


ire ■ 


Ol 


rUOIIC 


V 

T 


TreDelnit 


Deinitialize Tree object 


T«» 

ire • 


DO 


Public 


N 


TreDestroy 


Oeinitialize Tree object and free space 


ire ■ 


64 


rUtXIC 


Kl 
N 


TreDestroyChlldren 


Destroy any children of a ire 


Tre- 


65 


PUDIlC 


N 


TreRrstChild 


Return first child 


ire • 


66 


rrivate 


V 

Y 


TreHasChildren 


Does node have any children 


Tre- 


68 


rUDIIC 


v 

Y 


TreHasSiblings 


Does node have any siblings 


ire- 


69 


Public 


V 

Y 


Trelnit 


Initialize tree object 


Tro - 

ire - 


/U 


rUUllw 


M 
IN 


TrelsChild 


Does the node have a parent 


Tra . 

ire • 


71 


Piihlir 
rUDIIC 


Y 
T 


TrelsDirectAncestor 


Is node a direct ancester 


Tra - 

ire 


70 


Pi ihiir 


M 

IX 


TrelsRoot 


Does the node have no parent 


Tro . 


/O 


Pi iNir 


Y 


TreLastChild 


Return last child 


Tro . 

ire ' 




rnvaic 


Y 
T 


TreLastLeaf 


Return last leaf 


Tro 

ire ' 


7ft 
• /O 


rnValc 


Kf 
IN 


TreNext 


Return next node 


Tro . 

ire ' 


. 7R 


rilValc 


Y 

T 


TreNextPreOrder 


Return next node PreOrderly 


Tra 

ire • 


on 

' ou 


rnvaie 


Kl 
IN 


TreNextUncle 


Return next uncle 


Tro 

ire • 


' 06 


Dru#ota 

rnvaie 


Kt 
IN 


TreParent 


Return parent node 


Tr» . 

ire • 


• OH 


rnvdlc 


Y 


TrePasteRangeAfterSibling 


Paste range of siblings 


Tro 

1 re 


. lift 


Pi ihlir 


Y 


TrePasteRangeBeforeSibling 


Paste range of siDiings 


Tro 


- 00 


Pi iKItr 


Y 

T 


TrePasteRangeRrstChild 


Paste children 


Tro 

1 re 


- on 


Pi ihlir 


Y 


TrePasteRangeLastChild 


Paste children 


Tra 

1 re 




Pi iMi^ 
rUiXIU 


Y 

T 


TrePrev 


Return previous node 


Tro 

1 re 


OA 
■ jH 


rnvaic 


Y 

T 


TrePrevPreOrder 


Return previous node PreOrderly 


Tro 

ire 


. Oft 

• yo 


rnvaic 


IN 


TreSendDestroy 


SerKi message for tree oestrucuon 


Tro 

1 le 


■ 570 


PiiMir 
r umiv 


N 

IX 


TreVisilBranchlnOrder 


Visit function. t)rancn in-oraer 


Tro 


. OQ 


r MValc 




TreVisitChildren 


Visit function, cniiaren 


Tro 


1 U 1 


Priwofp 
rllvatc 


IX 


TreVisitChildrenBwd 


Visit function, cniioren 


Tre 

1 IC 


- 103 


Private 


N 


TreVisitDescBranchlnOrder 


Visit function, oescenaenis 


Tro 
1 ic 


1 


priwatp 
r 1 ivaic 


N 
1^ 


TreVisitDesclnOrder 


Visit function: descendents 


Tre 


-107 


Private 


N 


TreVisitDesclnOrderBwd 


Visit function: descendents 


Tre 


- 109 


Private 


N 


TreVisitDescPreOrder 


Visit function: descendents 


Tre 


-111 


Private 


N 


TreVisitlnOrder 


Visit function: in-order 


Tre 


-113 


Private 


N 


TreVisitlnOrderBwd 


Visit function: in-order 


Tre 


-115 


Private 


N 


TreVisitLeaves 


Visit function: leaves 


Tre 


-117 


Private 


N 


TreVisitParents 


Visit function: nearest parents first 


Tre 


-119 


Private 


N 


TreVisitPreOrder 


Visit function: pre*order 


Tre 


■121 


Private 


N 


TreVisitRange 


Visit function: range 


Tre 


-123 


Private 


N 


TreVisitSuccPreOrder 


Visit function: all successors 


Tre 


-125 


Private 


N 


TreVisitSuccessors 


Visit function: successors 


Tre 


-127 


Private 


N 
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Function Name 



Description 



Page Scope Macro 



TskBasicAssert 

TskCondition 

TskDelnit 

TskOefaultlnit 

TskExit 

TskExitWithMsg 

TskGetArgc 

TskGetArgv 

TskGeExceptionCondition 

TskGeExceptionRIeName 

TskGetExceptionLineNo 

TskGetExceptfenType 

Tsklnit 

Tskislnitialized 

TskLogCond 

TskMainLogCond 

TskMainPreCond 

TskMainPlrCond 

TskManRaiseException 

^skNormalExit 

skOnException 

'skPopExceptionHandler 

skPreCond 

skPrintException 

skPropagateException 

skPlrCond 
TskPushExh 

skRaiseExceptk)n 



Foundation function 
Raise exception conditionally 
Deinitiaiize instance 
Initialize instance with defaults 
Exit program with code 
Exit program and print message 
Get main() argument count 
Get main() argument vector 
Return exception conditton 
Return filename of exception 
Return exception line mmber 
Return exception type 
Initialize instance 
Is the Task initialized 
^aise exception conditionally 
^aise exception conditionally 
^aise exception conditionally 
laise exception conditionally 
^aise exception unconditionally 
Exit task nomially 
Establish exception handler 
^p exception handler 
^aise exception conditionally 
^rint description of exception 
^ass last exception 
^aise exception conditionally 
Push ttie exception 
Raise exception unconditionally 



N/A 


unooc 


N 




rUDIIC 


N 




Di iKKa 
rUDIlC 


N 


1 5K - D 


Di ikltA 

rUDnC 


N 


ISK - 0 


PUt)llC 


N 


Tel/ 7 
ISK - 7 


Public 


N 


Tel/ Q 
ISK - 0 


Public 


N 


Tel/ n 

ISK - 9 


Public 


N 


ISK - 10 


Public 


N 


Tsk- 11 


Public 


N 


Tsk - 12 


Public 


N 


Tsk - 13 


Public 


N 


Tsk - 15 


Public 


N 




Undoc 


N 


ISK - 17 


Public 


N 


TSK - 19 


Public 


N 


Tsk -21 


Public 


N 


Tsk -23 


PuUfc 


N 


Tsk -25 


Public 


N 


Tsk -27 


PuWfc 


N 


Tsk -28 


Public 


N 


Tsk -30 


Publte 


N 


Tsk -32 


Public 


N 


Tsk-34 


Public 


N 


Tsk -36 


Public 


N 


Tsk -38 


Public 


N 


N/A 


Undoc 


N 


Tsk -40 


Public 


N 



VtxAsGrfLel 

VbcAslnDII 

VbcAsObj 

VtxAsOutDII 

VtxClear 

VtxConnectToGrf 

VhCountIn 

VbcCountOut 

VbcDelnit 

VtxDestroy 

VbcDisconnectFromGrf 
VtxRndOutEdg 
VtxRndOutEdgClient 
VbcGetClient 



Return list element in graph 

Return vertex as list of incoming edges 

Return edge as object 

Return vertex as list of outgoing edges 

Clear vertex 

Connect vertex to graph 

Count incoming edges 

Count outgoing edges 

Deinitiaiize the Vertex object 

Deinitiaiize Vertex object and free space 

Disconnect vertex from graph 

Visit search function: outgoing edges 

Visit search function: outgoing edges 

Return client of vertex 



Vtx-2 


Friend 


Y 


Vtx-3 


Friend 


N 


Vtx-4 


Private 


N 


Vtx-5 


Friend 


N 


Vtx-6 


Public 


N 


Vtx-7 


Public 


N 


Vtx-9 


Publfc 


Y 


Vtx-11 


Public 


Y 


Vtx-13 


Public 


N 


Vtx-14 


Public 


N 


Vtx-15 


Public 


Y 


Vtx-17 


Private 


N 


Vtx-19 


Public 


N 


Vtx-21 


Publk: 


Y 
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Function Name 

VtxGetRrstm 

VtxGeFirstOut 

VtxGelGrf 

VtxInGrf 

Vtxinit 

VlxSendDestroy 

VtxSlackSetup 

VtxVisitEdge 

VtxVisitEdgeaient 

VtxVisitlnEdge 

VtxVisitlnEdgeClient 

VtxVisitOutEdge 

VtxVisitOulEdgeClient 



Page Scope Macro 



Return first incoming edge 
Return first outgoing edge 
Return graph 
Is vertex in graph 
initialize the Vertex olqecl 
Send message for vertex destruction 
Set up values for topsort 
Visit function: each edge 
Visit function: each edge 
Visit function: incoming edge 
Visit function: incoming edge 
Visit function: outgoing edge 
Visit fonction: outgoing edge 



Vtx-22 

Vtx-23 

Vtx-24 

Vtx-26 

Vlx-25 

Vtx-27 

Vtx-28 

Vtx-29 

Vtx-31 

Vtx-33 

Vtx-35 

Vlx-37 

Vtx-39 



Public 

Public 

Friend 

Public 

Public 

Public 

Friend 

Friend 

Public 

Friend 

Public 

Friend 

Public 
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C+0 Datatypes 



Name 


Size 


ueTiniuon 


usage 


Blk 


20/00 


struct o/ock 


D/ocK Class 


Block 


20/00 


struct S/ocft 


o/DCn Class 


Bool 


4 
1 


char 


Boolean values. 1 rue or raise 


Call 


N/A 


(Void) 


Overrides* function returning value 


Char 


1 


char 


Text data 


Chr 


1 


char 


Text oata 


ClBSS 


4 CHOC 


SiniCl C//dSd 


UtaSS vlaSS 


Ciientrtr 




VOIQ 


^Qto AAintar f A t inlrnAuin frv/AA 

Uaia poinicr lO uniuiowi 1 lypc 


CIS 




siruci o/dSS 


UiaSS CiaSS 


Const 


/A 

N/A 


const 


identines function parameters wnicn are not moainea 


DateFormat 


2 


enum uaterormat 


uescnoe a oispiay rorinai lor aaies \see juiianume ana 


Dll 


0/12 


struct L/Sf 


u5< Class 


Opa 


8/10 


struct DynamicArray 


L/yna/n/cA/ray Class 


DynamicArray 


0 14 A 

8/10 


struct DynamicArray 


DynamicArray ciass 


Edg 


A^ A 

26/52 


Struct cgye 


ccf^e Class 


Edge 


AC/CO 

26/52 


Struct £of<96 


co^e Class 


bxcepuon 1 ype 


A 


AAi inn VAO AfiAnTi/no 

cMUm cxccpuon 1 yp6 


1 ype? Ul vAuCpUUI 1 y wl ICI aiCU \OCw f aOnf 


Excrilter 


2/4 


dOOI ( )( r I oK ; 


runciion puinier 10 cxccpiion niicrs ys^u iaoi\) 


cxt 


A 


enum cxcepiion 1 ype 


Tuna aI pvAontiAn AonorsifoH 

1 yp6 Ul cACcpuun yciiciaica 


False 


N/A 


((oOOIjU) 


Dooiean raise 


Flagso 


1 


unsignea cnar 


DM Tiags \o/ 


Flags 16 


A 

c 


unsignea snon 


Dll nags \id) 


Flags32 


4 


unsigned char 


Bit flags (32) 


GenericPtr 


2/4 


Void* 


Data pointer to unknown type 


Graph 


30/48 


stnjct Graph 


Graph dass 


Grf 


30/48 


struct Graph 


Graph class 


IntAddress 


2/4 


int/long 


Integer capable of holding a data address 


Jul 


4 


struct JulianTime 


JulianTime class 


JulianTime 


4 


stnjct JulianTime 


Ju//an77me class 


LARGE DATA PTRS 


N/A 


N/A 


Defined if 4 byte data pointers are the default 


LARGE.FUNC^PTRS 


N/A 


N/A 


Defined if 4 byte function pointers are the default 


Largeint 


4 


long 


Integers in the range [-2147483647:2147483647] 


Lei 


8/16 


staict ListElement 


/J5f£/emen/class 


LINE^NO 


N/A 


_LINE_ 


Line number in file being compiled 


Ust 


6/12 


struct Ust 


L/5f class 


ListElement 


8/16 


stoict ListElement 


/isfE/ernenf class 


m 


20/30 


struct MetaClass 


MetaC/ass class 


Mediumint 


2 


int 


Integers In range 1-3276732767) 



XV 



CfO Datatypes 



Name 


size 


Definition 


Usage 


i Jam 

Mem 


1 


char 


Afe/nory class 


Memory 


1 


char 


Afe/no/y class 


Message 


12/22 


struct Message 


Message dass 


MetaClass 


20/20 


struct MetaClass 


MetaClass class 


MetaMessage 


8/14 


struct MetaMessage 


MetaMessage c\ass 


MetaSuperClass 


12/22 


struct MetaSuperClass 


MetaSuperClass class 


Method 


2/4 


Void (*)( POBJ, ... ) 


FurKtion pointer (see Blockj 


MethodRetBool 


2/4 


Bool {•)( POBJ. ...) 


Function (returning Bool) pointer (see Blocki 


MethodRetInt 


2/4 


Mediumlntn( POBJ, ...) 


Function (returning Mediumint) pointer (see Btockf 


MethodRetDalaPtr 


2/4 


PMEM (*)( POBJ, ...) 


Function (returning data pointer) pointer (see Blockj 


MethodRetFuncPtr 


2/4 


PMTH n{ POBJ, ...) 


Function (returning function pointer) pointer (see Blockj 


MethodRetPtr 


2/4 


Void TK POBJ. ...) 


Function (returning pointer) pointer (see Block} 


Mms 


8/14 


struct MetaMessage 


MetaMessage ciass 


MODULE_NAME 


N/A 


_FILE_ 


Name of file being compiled 


Msg 


12/22 


struct MetaSuperClass 


MetaSuperClass dass 


Msg 


12/22 


struct Message 


Afessa^e class 


NULL 


2/4 


0 


Used to assign or return null pointers 


Obj 


2/4 


struct Object 


Object tiass 


Object 


2/4 


struct Object 


Object dass 


PBLK 


2/4 


struct Block* 


Block pointer - does not require stmctune definition 


PCIO 


2/4 


struct ConsolelnputOutput * 


ConsolelnputOutput pointer - does not require structure 
definition 


PCLS 


2/4 


struct Class * 


Class pointer - does not require structure definition 


POLL 


2/4 


struct List* 


/is/ pointer - does not require structure definition 


PDPA 


2/4 


struct DynamicArray* 


DynamicArray pointer • does not require structure 
definition 


PEDG 


2/4 


struct Edge * 


Edge pointer - does not require stnjcture definition 


PGRF 


2/4 


struct Grapti * 


Graph pointer • does not require stmcture definition 


PJUL 


2/4 


struct JulianTime * 


JulianTime pointer • does not require stnjcture definition 


PLEL 


2/4 


struct L/s/£/e/nen/* 


L/s/£/e/nenf pointer - does not require structure definition 


PMCL 


2/4 


struct AfetaCi!a55* 


MetaClass pointer - does not require structure definition 


PMEM 


2/4 


Char* 


Mem pointer - does not require stnjcture definition 


PMMS 


2/4 


struct MetaMessage * 


MetaMessage pointer - does not require staicture definition 


PMSC 


2/4 


struct MetaSuperClass * 


MetaSuperClass pointer - does not require sbuclure 
definition 


PMSG 


2/4 


struct Message * 


Message pointer - does not require structure definition 


PMTH 


2/4 


VoidCK POBJ, ...) 


Function pointer (see Blockj 


POBJ 


2/4 


struct Ofc/ecf* 


Object pointer - does not require structure definition. Also 


PSTR 






synonymous with a dass pointer of unknown type 


2/4 


char* 


Null terminated text strings 


PTRE 


2/4 


struct Tree * 


Tree pointer - does not require stmcture definition 


PTSK 


2/4 


struct Task * 


Task pointer • does not require stnjcture definition 


PVTX 


2/4 


struct l/'e/tex* 


Vertex pointer - does not require stmcture definition 


Real 


8 


double 


Roating point (no range specified) 


Regl 


N/A 


register 


Prioritized register allocation 
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npfiniflnn 

WCIIIIIUWII 


lIcariA 






icgiolci 


PriArili7oH ronietor dilA^tinn 
rllonU^CU it?yi9l»i aliwUaUUII 






rpnictor 


Prinriii7pH rpniQtpr alkv^Hnn 


ney*f 


M/A 




Prinriti7oH rpnictor sit/v^tiAn 

rnonu^cu icyioici aiRAxiiiuii 




N/A 


rpnictfir 
i cyidici 


Prinriti7PH rpni^tpf Altn^tion 


Cmallfnt 
Oiiiallllil 


1 
1 




Intpnorc in rarviP f-197"x19TI 
iiiicycio III laiiyc [ tci .ti£/j 


Ou 


i 




Tpvt Hatsi 
1 CAi Uaui 


oCT/ny 


1 


char 


leXlQaul 






Struct rasK 


/asK Class 


ire 




siruci ireu 


/ r&e Class 


Tree 


16/32 


Struct Tree 


Tree dass 


True 


N/A 


((Bool)1) 


Boolean True 


Tsk 


24/32 


struct Task 


Tas^dass 


ULargeInt 


4 


unsigned long 


Integers in the range IO^)xFFFFFFFF] 


UMediumtnt 


2 


unsigned int 


Integers in the range [O.'OxFFFF] 


USmalllnt 


1 


unsigned char 


Integers in range [OiOxFF] 


Vertex 


22/44 


stmct Vertex 


Vertex dass 


Void 


N/A 


void 


Function dedarations 


Volatile 


N/A 


volatile 


(default) Identifies function parameters which are modified 


Vtx 


22/44 


stmct Vertex 


V^ertexdass 
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Class Reference for Block 



structure Name: Block 

Abbreviation: BIk 

Ciass Type: Primitive Class 



BIkClear 



Summary 

#include "cobjects.h" 
#include 'Ijlkmac.h" 

Void BlkClear(pBlk) 
PBLK pBlk; 

Public Function 

Purpose 

The BIkClear function clears the parameters of the Btocic pBlk. 

Parameter - Description 

pBlk - Pointer to a structure of type Block. 
Return Value 

No return value 

Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BIkClear function. 



Blk-2 



BIkDelnit 



Summary 

#include "cobjects.h" 
#lnclude 'Tjlkmach" 

Void 61kDeInit( pBlk ) 

PBLK pBlk; 

Public Function 

Purpose 

The BIkDelnit function deinitializes the Block pBlk. It should be the last call 
referencing pBlk before deallocating it. 

Parameter - Description 

pBlk - Pointer to a structure of type Btocfc. 

Return Value 

No return value 
Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BIkDelnit function. 



Blk-3 



BIkExecuteRetDataPtr 



Summary 

#include "cobjects.h' 
#include "blkmac.h" 



Void 

PBLK 

POBJ 




Public Function 



Purpose 



The BIkExecuteRetDataPtr function executes the method in the Block pBlk and 
passes any parameters to it. The first parameter passed will be the Object pObi. 
The return value is a data pointer (Void •) returned firom the method. 

Parameter - Description 



Return Vaiue 

No return value 

Notes 

The return value firom the BIkExecuteRetDataPtr fimction is a data pointer 
(Void *) returned firom the method executed. 

IpBlk must contain a non NULL method pointer.] 

Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BIkExecuteRetDataPtr function. 



pBlk 
pObJ 



Pointer to a structure of type Block. 
Pointer to a structure of type Object 



Blk-6 



BIkExecuteRetFuncPtr 



Summary 

#include "cobjects.h" 
#include Talkmac.h" 

PMTH BlkExecuteRetFuncPtr( pBlk, pObj ) 

PBLK pBlk: 
POBJ pObj: 

Public Function 

Puipose 

The BIkExecuteRetFuncPtr function executes the method in the Block pBIk and 
passes parameters to it. The first parameter passed will be the Object pObj. The 
return value is a Method pointer returned from the method. 

Parameter - Description 



pBlk - Pointer to a structure of type Block. 
pObJ - Pointer to a structure of type Object 

Return Value 

The return value from the BIkExecuteRetFuncPtr function is a Method pointer 
returned firom the method executed. 

Notes 

IpBlk must contain a non NULL method pointer.] 



Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkElxecuteRetFimcPtr function. 



Blk-7 



BIkExecuteRetInt 



Summary 

#include "cobjects.h' 
#include "blkmac.h" 



Meditunint 

PBLK 

POBJ 



BlkExecuteRetlnK pBUc, pObj ) 
pObj; 



Public Function 

Purpose 

The BIkExecuteRetInt function executes the method in the Block pBlk and 
passes parameters to it. The first parameter passed will be the Ob/ect pObJ. The 
return value is a Mediumint returned from the method. 

Parameter - Description 

pBlk - Pointer to a structure of type Block. 
pObJ - Pointer to a structure of type Object 

Return Vaiue 

The return value of BIkExecuteRetInt is a Mediumint returned from the 
method executed. 

Notes 

[pBlk must contain a non NULL method pointer.] 

Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BIkExecuteRetInt function. 



Blk-8 



BlkHasMethod 



Summary 

#include "cobjects.h" 
#include "blkmac.h" 

Bool BlkHasMethod(pBlk) 
PBLK pBlk: 

Public Function 

Purpose 

The BlkHasMethod function returns True if the Btocfc pBlk has a non-NULL 
Method pointer associated with it. otherwise False is returned. 

Parameter - Description 

pBlk - Pointer to a structure of type Block. 

Return Value 

The return value from the BlkHasMethod function is True if pBlk has a non- 
NULL value and False if it is NULL. 

Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BlkHasMethod function. 



Blk-9 



BIklnit 



Summary 

#lnclude "cobjects.h" 
#lnclude 'T^lkmach" 

Void Blklniti pBlk, pMth ) 

PBLK pBIk; 
PMTH pMth; 

PubHc Function 

Purpose 

Tlie Blklnlt function the Block pBlk and sets its method to the 

bee^ ^oc^eT should be the first function caUed after pBlk has 

Parameter - Description 

pBIk - Pointer to a structure of type Block. 
pMth - Pointer to a Method. 

Return Vaiue 

No retiam value 

Example 

Bl^t ftSction procedure TSTBLK.C for an example of the use of the 



BIk - 10 



BIkPrint 



Summary 

#include "cobjects.h" 
#include "blkmac.h" 



BlkPrinU pBlk, pCio, item, level, name ) 
pBlk; 
pClo; 

item; 
level; 
name; 



Void 
PBLK 
PCIO 

Mediumint 
Mediimiint 
PSTO 

Public Function 

Purpose 

Thi» RlkPrint function prints the contents of the BUxk pBlk on the 

Parameter - Description 



pBlk 
pCio 
item 
level 
name 

Return Value 

No retxim value 



Pointer to a structure of type Btocfc. . x 

Pointer to a structure of type ConsolelnputOutput. 
The array element number of this instance lor -ij. 
The level of indentation to print this object with. 
The name of this instance. 



Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BIkPrint function. 



Bik- n 



BIkPushDataPtr 



Summary 

#include "cobjects.h" 
#lnclude "blkmac.h" 

Void BlkPushDataPti( pBlk, p ) 

PBLK pBlk: *^ 

PMEM p; 

Public Function 

Purpose 

"me BIkPushDataPtr function pushes the data pointer Memory p onto the Block 

Parameter - Description 

pBlk - Pointer to a structure of type Block. 

p - Pointer to Mem. The pointer parameter being pushed. 

Return Vaiue 

No return value 

Notes 

[The total nimiber of parameters must not be larger than the parameter array.] 

Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BIkPushDataPtr function. 



BIk- 12 



BIkPushFuncPtr 



Summary 

#include "cobjects.h" 
#lnclude "blkmac.h" 

Void BlkPushFuncPtr( pBlk, p ) 

PBLK pBlk: 

PMTH p; 

Public Fiinctlon 

Purpose 

-me BIkPushFuncPtr function pushes the function pointer Method p onto the 
Block pBlk. 

Parameter - Description 

nPiik - Pointer to a structure of type Block. Ko4«tf 

- Pointer to Method. The pointer parameter being 
pushed. 

Return Value 

No return value 

Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BIkPushFuncPtr function. 



BIk- 



BIkPushLargeInt 



Summary 

#include "cobjects.h" 
#include "TDlkmach" 

Void BlkPushLaigcInt( pBlk, p ) 

PBLK pBlk: ^ 1' /F' 

Largeint p; 
Public Function 

Purpose 

^eBlkPushLargelnt function pushes the value p onto the parameter Block 

Parameter - Description 

pBlk - Pointer to a structure of type Btoclc. 
P - The integer parameter being pushed. 

Return Value 

No return value 

Notes 

rnie total number of parameters must not be larger than the parameter array.] 

Exampie 

St^^ if®'" ^°T^^f ® procedure TSTBLK.C for an example of the use of the 
BlicPushLargeInt function. 
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BIkPushMediumInt 



Summary 

#lnclude "cobjects.h" 
#include "blkmac.h" 

Void BlkPushMediumlnK pBlk, p ) 

PBLK pBlk: 
Mediumint p: 

Public Punctlon 

Purpose 

Hie BIkPushMediumInt function pushes the value p onto the parameter Block 
pBlk. 

Parameter - Description 

oBlk - Pointer to a structure of type Btocfc. 
p - The integer parameter being pushed. 

Return Value 

No return value 

Notes 

IThe total number of parameters must not be larger than the parameter array.) 
Example 

Please refer to class test procedure TSTBLK.C for an example of the use of the 
BIkPushMediumInt function. 
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BIkSetMethod 



Summary 

#include "cobjects.h' 
#include "blkmac.h" 



Void 

PBLK 

PMTH 




Public Function 



Purpose 




pointer to Method pMth as the function 



Parameter - Description 

pBlk - Pointer to a structure of type Block. 
pMth - Pointer to a Method. 

Return Value 

No return value 

Example 

SS^Mf^ class test procedure TSTBLK.C for an example of the use of the 
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Class Reference for Class 



structure Name: Class 

Abbreviation: Cis 

Class Type: Primitive class 



CIsCreateObJect 



Summary 

#include "cobjects.h" 
♦Include "clsmac.h" 

POBJ asCrealeObjcct(pCls) 
PCLS pCls; 

Public Function 

Purpose 

J^ClsCreateObject function creates a new Object of the type specified by the 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

Return Value 

""^^^T. value from the ClsCreateObject function is a pointer to a structure 
of type Object and is the new object instance. "^tuxc 

Notes 

The pointer returned by ClsCreateObject actuaUy is a pointer to two types of 
structure. It is a pointer to the type which is described by the Class pCls and it 
is a pointer to type Object The reason for this is that aU structures which 
either inherit or are inherited from are defined as having their first structure 
member be a structure of type Object In this way, the two structures are 
superimposed upon one another. 

(The class must not have any sub-classes.] 

Example 
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CIsDelnit 



Summary 

#include "cobjects.h' 
#include "clsmac.h" 



Void 
PCLS 



asDeInit( pOs ) 
pCls; 



Public Function 



Purpose 

The CIsDelnit function deinitiallzes the Class pCls. The ClsDelnlt function 
should be the last function called when done using pCls and just pnor to 
freeing its memory. 

Parameter - Description 



See Also 

ClsDestiroy, Clslnlt, MdSendCreateClass, MclSendDestroyClass 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsDelnit function. 



pCls 
Return Value 



Pointer to a structure of type Class. 



No return value 



Notes 
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CIs Destroy 

Summary 

#include "cobjects.h" 
#include "clsmach" 

Void asDestroy( pds ) 

PCLS pCls; 

Public Function 

Purpose 



The ClsDestroy function deinitializes the Class pCls and deallocates the 
memory used by It. Hie Class pCls should not be referenced after this ftinction 



is called 
Parameter - Description 



pCls - Pointer to a structure of type Class. 
Return Value 

No return value 

Notes 

Any superclasses owned by pCls are destroyed as well. 
Any messages owned by pCls are destroyed as well. 

pels should point to a Class which was created by MclSendCreateClass. If pCls 
points to statically allocated memory then the caller should use ClsDelnit 
instead of this function. 

See Also 

ClsDelnit, Clslnit, MclSendCreateClass. MclSendDestroyClass 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
ClsDestroy function. 
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CIsDestroyObject 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Void asDestroyObject( pQs, pObj ) 

PCLS pCls: 
POBJ pObJ; 

Public Function 

Purpose 

The CIsDestroyObject function deallocates the memory associated with the 
Object pObJ whose type Is specified by the Class pCls. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 
pObj - Pointer to a structure of type Object • 

Return Vaiue 

No return value 

Notes 

pObj must have been deinitialized prior to calling this function. 
pCls must be a root class, i.e. it has no subclasses. 
pObJ must have been allocated by ClsCreateObject. 
(The class must not have any sub-classes.] 

See Aiso 

ClsCreateObject 
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CIS Destroy Object 
Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
ClsDestroyObject function. 



CIS- 6 



CIsFindMsg 



Summary 

#include "cobjects.h' 
#lnclude "dsmac.h" 



PMSG 

PCLS 

PSTR 



QsFindMsgC pQs, pStr ) 

pCls; 

pStr; 



Public Function 

Purpose 

The ClsFlndMsg function finds searches the Class pCls for the message 
selector pStr and retiims a pointer to the Message if found or NULL, il n 
found. 

Parameter - Description 



Return Value 

The return value from the CIsFindMsg function is a pointer to a structure of 
type Message which contains the message selector pStr. NULL is returned il it 
is not found. 

Notes 

The search is case-sensitive. 

Selector strings should generally by mixed case without spaces and with the 
first character lowercase. 

See Also 

ClsFindSelectorlndex 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsFindMsg function. 



pCls 
pSti: 



Pointer to a structure of type Class. 

Pointer to a String containing the selector name. 
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CIsFindSelectorlndex 



Summary 



#include "cobjects.h" 
#include "clsmac.h" 




Public Function 



Purpose 



The CIsFindSelectorlndex function searches the Class pCls for the message 
selector string pStr and returns the index of the selector if found and -1 ifnot 
found. 

Parameter - Description 



range: The return value will be in the range I0:N-1] where N is the number of 
messages pCls responds to. 

Return Value 

The return value from the CIsFindSelectorlndex function is the index of the 
message if found and -1 if not found. 

Notes 

The search is case-sensitive. 

Selector strings should generally by mixed case without spaces and with the 
first character lowercase. 

The return value can subsequently be used in the ClsSendObJectMessage 
function to send a message to an object. 



pCls 
pStr 



Pointer to a structure of type Class. 

Pointer to a String containing the selector name. 
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CIsFindSelectorlndex 

See Also 

CIsFindSelectorlndex, ClsSendObjectMessage 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsFindSelectorlndex function. 
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CIsFindSuperClass 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 



PCLS 
PCLS 
PSTR 



asFmdSuperaass( pQs, pSlr ) 

pCls; 

pStr; 



Public Function 

Purpose 

Hie CIsFindSuperClass function finds searches the Class pCls for the 
superclass identified by the string pStr and retiams a pointer to the superclass 
if found and NULL if not found. 

Parameter - Description 



pels - Pointer to a structure of type Class. 

pStr ■ - Pointer to a String containing the superclass name. 

Return Value 

The return value from the function CIsFindSuperClass is a pointer to a 
structure of type Class which is the superclass identified by pStr. NUIX is 
returned if it is not foimd. 

Notes 

The search is case-sensitive. 

Superclass names should generally by named the same as the structure that 
they describe. 



Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsFindSuperClass function. 
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CIsGetMessageCount 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Mediumint QsGetMessageCotmt( pQs ) 
PCLS pCls: 

Public Function 

Purpose 

The CIsGetMessageCount function returns the number of messages the Class 
pCls can respond to. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

Range: The range of the return value is IO:SHKr_MAX] where SHKT.MAX is 
defined in the include file <limits.h>. 

Return Value 

The return value from the function CIsGetMessageCount function is the 
number of messages pCls responds to. 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
ClsGetMessageCoimt function. 
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CIsGetMethodAndOffset 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 



Void asGetMelhodAndOf fset( pQs, m, ppMth, pOffset ) 

PCLS pCls; 

Mediumint m; 

PMTH *ppMth; 

Mediumint *pO£fset; 



Public Function 

Purpose 

The CIsGetMethodAndOffset function returns a pointer to the Method and Uie 
offset of the object (relative to this class) which owns the method. The Method 
pointer is returned in ppMth and the offset is returned in pOffset. The method 
and offset are determined by the message index m within the Class pCls. 



Parameter - Description 



pCls - Pointer to a structure of type Class. 
m - The index of the message selector. 

ppMth - Pointer to a pointer to a Method function. The method 
is returned here. 

pOffset - Pointer to a Meditmilnt. The offset is returned here. 



range: *pOffset will be in the range [-2000:+2000]. A negative value indicates 
the message is being overridden by a subclass. A positive value means a 
superclass flmction is being inherited. A value of 0 means pCls is 
defining/overriding the method. 

Return Value 

No return value 
Notes 

m must be in the range I0:N-1] where N is the number of messages to which 
pCls can respond to. 
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CIsGetMethodAndOffset 



Notes (com) 

"^pMth will point to a function after this call. 

(The message niomber must be greater than or equal to zero, and less than the 
nimiber of messages.] 

See Also 

ClsGetNthMessage 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetMethodAndOffset ftmction. 
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CIsGetName 



Summary 

#include "cobjects.h" 
#include "dsmac.h" 

PSTR asGetName(pas) 
PCLS pCls: 

Public Function 

Purpose 

The CIsGetName function returns a pointer to a String containing the name of 
the Class pCls. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

Return Value 

The return value from the CIsGetName function is a pointer to a Strtr^ 
containing the name of the Class pCls. 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetName function. 
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CIsGetNthMsg 



Summary 

#include "cobjects.h" 
#lnclude "dsmac.h" 

PMSG asGetNthMsg( pQs, n ) 

PCLS pCls; 
Mediumint n; 

Public Function 

Purpose 

The CIsGetNthMsg function returns a pointer to a structure of type Message 
given the index m for the Class pCls. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 
m - The index of the message 

range: m must be in the range 10:N-11 where N is the number of messages pCls 
responds to. 

Return Value 

The return value from the CIsGetNthMsg function is a pointer to a structure of 
type Message which is the Nth message of pCls. 

Notes 

(The message number must be greater than or equal to zero, and less than the 
nimiber of messages.] 

See Also 

ClsGetMethodAndOfifset 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetNthMsg function. 
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CIsGetNthSuperClass 



Summary 

#lnclude "cobjects.h" 
#include "clsmac.h" 

PCLS asGetNthSuperaass(pas,n) 
PCLS pCls; *^ 

Mediumlnt n; 

Public Function 

Purpose 

The CIsGetNthSuperClass function returns a pointer to a structure of tvoe 
Class which Is the nth superclass of the Class pCls. 

Parameter - Description 

pCls - Pointer to a structure of type Class, 
n - The index of the superclass. 

pCl?* n must be in the range [0:N-1I where N is the number of superclasses of 

Return Vaiue 

The return value from the CIsGetNthSuperClass function is a pointer to a 
structure of type Class which is the Nth superclass of pCls. 

Notes 

(The super class index must be greater than or equal to zero, and less than the 
number of superclasses.] 

Example 

?i®??®*kt!uo ^ ^i^f® procedure TSTCLS.C for an example of the use of the 
CIsGetNthSuperClass function. 
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CIsGetObjectSize 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Mediiunint QsGetObjectSizeC pQs ) 
PCLS pCls: 

Public Function 

Purpose 

The CIsGetObjectSize function returns the size in bytes of an (super) object 
described by the (super) Class pCls. 

Parameter - Description 

pCls - Pointer to a structure of type Class, 

Return Vaiue 

The return value from the CIsGetObjectSize function is the size of an object of 
this class in bytes. 

Notes 

To get the size of the entire (root) object, not just the superobject use the 
function ClsGetRootObjectSize. 

See Also 

ClsGetRootObjectSize 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetObjectSize function. 
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CIsGetOffsetForMsg 



Summary 

#Include "cobjects.h" 
#include "clsmach" 

Mediumint asGetOf£setForMsg( pOs, m ) 
PCLS pCls: 
Mediumint m; 

Public Function 

Purpose 

The ClsGetCMfsetForMse function retiams the offset of the object (relative to an 
object of the Class pClsJ which ultimately responds to the message index m. 

Parameter - Description 



pCls - Pointer to a structure of type Class. 
m - The index of the message selector. 

range: m must be in the range I0:N-1] where N is the nimiber of messages to 
which pCls can respond to. 

Return Value 

The return value from the CIsGetOffsetForMsg function is the offset of the 
object which ultimately handles the message m. 

Notes 

The return value will be in the range I-2000:+2000].. A negative value indicates 
the message is being overridden by a subclass. A positive value means a 
superclass function is being inherited. A value of 0 means pCls is 
denning/overriding the method. 

[The message number must be greater than or equal to zero, and less than the 
number of messages.] 
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CIsGetOffsetForMsg 

See Also 

ClsGetMethodAndOffset, ClsGetNthMsg 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetOffsetForMsg function. 
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CIsGetOffsetOfNthSuper 



Summary 

#inolude "cobjects.h" 
#lnclude "clsmac.h" 

Mediumlnt QsGetOffsetOfNthSuperC pQs, n ) 
PCLS pCls: 
Mediumlnt n; 

Public Function 

Purpose 

The CIsGetOffsetOfNthSuper function returns the offset of the object (relative to 
an object of the Class pCls) which is the Nth superclass of pCls. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 
n - The index of the superclass. 

range: n must be in the range I0:N-1] where N is the nimiber of superclasses of 
pCls. 

Return Vaiue 

The return value from the CIsGetOffsetOfNthSuper function is the offset from 
an Object of Class pCls needed to get to the Nth superclass. 

Notes 

The return value will be in the range [0:2000]. 

[The super class index must be greater than or equal to zero, and less than the 
nimiber of superclasses.) 

See Also 

ClsGetNthSuperClass 
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CIsGetOffsetOfNthSuper 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetOffsetOfNthSuper function. 
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CIsGetRootSubClass 



Summary 

#include "cobjects.h' 
#include "clsmac.h" 



PCLS 

PCLS 



QsGetRootSubQassC pQs ) 
pCls: 



Public Function 



Purpose 



The CIsGetRootSubClass function returns a pointer to a structure of type Class 
which is tlie outermost subclass of the Class pCls. 



Return Value 

The return value from the CIsGetRootSubClass function is a pointer to a 
structure of type Class which is the outermost subclass of the Class pCls. 



By definition, the returned Class cannot have a subclass. 
The root subclass of the returned value is itself. 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetRootSubClass function. 



Parameter - Description 



pCls 



Pointer to a structure of type Class. 



Notes 
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CIsGetRootSubObjectOffset 



Summary 

#include "cobjects.h" 
#lnclude "clsmac.h" 

Mediumint QsGetRootSubObjectOffseK pQs ) 
PCLS pCls: 

Public Function 

Purpose 

The ClsGetRootSubObjectOflfset function returns the offset in bytes of the root 
object described by the Class pCls. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

Return Value 

The return value from the ClsGetRootSubObjectOflfset fimction is the offset of a 
root object of Class pCls In bytes. 

Notes 

The root Object is an instance of the root Class which is the subclass of pCls 
which has no subclass. 

The return value is in the range {-2000:01. 

See Also 

ClsGetObjectSize. ClsGetRootSubClass, ClsGetRootSubObjectSize 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
ClsGetRootSubObjectOflfset function. 
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CIsGetRootSubObJectSize 



Summary 

#include "cobjects.h" 
#include "dsmac.h" 

Mediumlnt ClsGetRootSubObjectSize( pQs ) 
PCLS pCls; 

Public Function 

Purpose 

Hie ClsGetRootSubObjectSize function returns the size in bjrtes of a root object 
described by the Class pCls. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

Return Value 

The return value from the ClsGetRootSubObjectSize function is the size of a 
root object of pCls in bytes. 

Notes 

The root Object is an instance of the root Class which is the subclass of pCls 
which has no subclass. 

See Also 

ClsGetObjectSize, ClsGetElootSubClass, ClsGetRootSubObjectOfifset 
Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
ClsGetRootSubObjectSize function. 
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CIsGetSize 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Mediumint QsGetSizeC pQs ) 
PCLS pCls; 

Public Function 

Purpose 

The ClsGetSIze function returns the size of the Class pCls in b3rtes. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 
Return Value 

The return value from the CIsGetSize function is the size of the Class pCls in 
b3rtes. 

Notes 

Typically, the size of a class is sizeofi Class ), however you can create classes 
which have larger sizes (for holding class specific data). See the section on 
MetaClass for further det£iils. 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetSize function. 
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CIsGetSubClass 



Summary 

#include "cobjects.h' 
#include "clsmac.h" 



PCXS 
PCLS 



asGetSubOassCpCls ) 
pCls; 



Public Function 



Purpose 



The CIsGetSubClass function returns the subclass of the Class pCls or NULL if 
the Class pCls has no subclass. 

Parameter - Description 



Return Value 

The return value from the CIsGetSubClass function is a pointer to a structure 
of type Class which is the subclass of pCls. If pCls has no subclass. NULL is 
returned. 

Notes 

If NULL is returned, then pCls is the root Class. 

See Also 

ClsGetRpotSubClass, ClsGetNthSuperClass 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetSubClass function. 



pCls 



Pointer to a structure of type Class. 
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CIsGetSubObjectOffset 



Summary 

#lnclude "cobjects.h" 
#include "dsmac.h" 

Mediumlnt QsGetSubObjectOffseK pCls ) 
PCLS pCls; 

Public Function 

Purpose 

The CIsGetSubObjectOffset function returns the offset in bjrtes of an object of 
Class pels from its subclass. 

Parameter - Description 

pels - Pointer to a structure of type Class. 
Return Value 

The return value from the CIsGetSubObjectOffset function is the offset in bytes 
from an object of pCls to an object of the subclass of pCls. 

Notes 

The return value is in the range [-2000:0]. 

See Also 

ClsGetRootSubObjectOffset 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetSubObjectOffset function. 
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CIsGetSuperClassCount 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Mediumint asGetSuperaassCount( pQs ) 
PCLS pCls; 

Public Function 

Purpose 

The CIsGetSuperClassCount function returns the number of superclasses in 
tiie Class pels. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

Return Value 

The return value from the ClsGetSuperClassCoimt function is the number of 
superclasses in pCls. 

Notes 

The range of the return value is (0:30]. 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetSuperClassCount fimction. 
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CIsGetSuperClasslndex 



Summary 

#include "cobjects.h" 
#include "clsmac.h" 

Mediumlnt QsGetSupeiQassIndexC pds ) 
PCLS pCls; 

Public Function 

Purpose 

The CIsGetSuperClasslndex function returns the index of the superclass pCls. 
If the Class pCls is not a superclass, it returns -1. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

Return Value 

The return value from the CIsGetSuperClasslndex function is the index of the 
superclass pCls. If pCls is not a superclass - 1 is returned. 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsGetSuperClasslndex function. 
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CIslnit 



Summary 

#include "cobjects.h' 
#include "clsmac.h" 



Void 

PCLS 

PMCL 



asIniKpQs^pMcl) 

pCls; 

pMcl: 



Public Function 



Purpose 

The ClsInit function initializes the Class pCls. 

Parameter - Description 



pCls 



Pointer to a structure of type Class. 



Return Value 

No return value 

Notes 

If you create a Class with the MclSendCreateClass function, you do not need to 
call ClsInit as it is called for you. However, if pCls points to statically allocated 
memory, you must call ClsInit before attempting to use any other Class 
fiinctions. When you are done with pCls, you should deinitialize it with 
ClsDelnit. 

See Also 

ClsDelnit, ClsDestroy, MclSendCreateClass, MclSendDestroyClass 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
ClsInit function. 
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CIslsRoot 



Summary 

#lnclude "cobJects.h" 
#include "clsmac.h" 

Bool QsIsRootC pQs ) 

PCLS pCls; 

Public Function 

Purpose 

The ClsIsRoot ftmction returns True if the Class pCls is the root subclass, 
otherwise False is returned. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

Return Value 

The return value from the ClsIsRoot function is True if pCls is the root 
subclass otherwise False is returned. 

Notes 

A root subclass is a class which has no subclasses. 

Example 

Please refer to class test procedure TSTCLS.C for £in example of the use of the 
ClsIsRoot function. 
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CIsPrint 



Summary 

#lnclude "lobjects.h' 
#lnclude "dsmac.h" 



Void 

PCLS 

PCIO 



pCls; 
pClo: 
item; 
level; 
name; 



QsPrmt( pCls, pCio, item, level, name ) 



Meditmiint 
Mediumint 
PSTTR 



Public Function 

Purpose 

The CIsPrint function prints the contents of the Class pCls on the 
ConsolelnputOutput device pCio. The item parameter is the array index of this 
instance or -1 if it is not an array element, level is a number indicating the level 
of indentation, and name is a String pointer which is the name of this instance. 

Parameter - Description 



Return Value 

No return value 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsPrint function. 



pCio 
item 
level 
name 



pCls 



Pointer to a structure of type Class. The Class being 
searched. 

Pointer to a structure of type ConsolelnputOutput. 
The array element number of this instance (or -1). 
The level of indentation to print this object with. 
The name of this instance. 
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CIsSend Destroy 



Summary 

#include "cobjects.h" 
#include "dsmac.h" 

Void QsSendDestroyC pds ) 

PCLS pCls; 

Public Function 

Purpose 

The ClsSendMessage destroys the Class pCls with the proper Class destructor 
function. 

Parameter - Description 

pCls - Pointer to a structure of type Class. 

Return Value 

No return value 

See Also 

ClsDestroy, ClsDelnit, MclSendCreateClass, MdSendDestroyClass 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
ClsSendDestroy function. 
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CIsSendObjectMessage 



Summary 

#include "cobjects.h" 
#include "clsmach" 



Void asSendObiectMessage( pQs, pOb L pBIk ) 

PCLS pCls: 

POBJ pObJ; 

Mediumint m; 

PBLK pBlk: 



Public Function 

Purpose 

The CIsSendObjectMessage fianction sends the message indicated by the 
selector index m to the Object pObi which is an object of Class pCls. 
Parameters are sent to the methodf through the Block pBIk. 

Parameter - Description 



pCls - Pointer to a structure of type Class. 

pObJ - Pointer to a structure of type Object. The object 

receiving the message, 
m - The selector index. 

pBlk - Pointer to a structure of type Block. Optional 
parameters to pass to the method. 



range: m must be in the range I0:N-11 where N is the nimiber of messages pCls 
responds to. 

Return Value 

No return value 
Notes 

If pBlk has a method set it is ignored and the is set to the method indicated by 
the message index m. 

pObj is not necessarily the precise object which receives the message. pObj is 
offset by an amount determined by the message first. Therefore, a subobject or 
superobject of pObj may be the ultimate receiver of the message. 
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CIsSendObjectMessage 



Notes (cont) 

[The message number must be greater than or equal to zero, and less than the 
nimiber of messages.] 

See Also 

ClsSendMessageRetlnt. ClsSendMessageRetPtr 
Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsSendObjectMessage function. 
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CIsSendObjectMessageReturnInt 



Summary 

#include "cobjects.h' 
#include "clsmac.h" 



PCLS 
POBJ 



Mediumint 



QsSendOb jectMessageRetuinInt( pCls, pOb j, m, pBlk ) 

pCls: 
pObj; 



Mediumint 
PBLK 



m; 

pBlk; 



Public Function 



Purpose 



The ClsSendObJectMessageRetlnt function sends the message indicated by the 
selector index m to the Object pObi which is an object of doss pCls. 
Parameters are sent to the method through the Block pBlk. The return value is 
the return value from the method called. 



range: m must be in the range I0:N-1] where N is the nimiber of messages pCls 
responds to. 

Return Value 

The return value from the ClsSendObJectMessageRetlnt function is the return 



value from the method which is called. 

Notes 

If pBlk has a method set It is ignored and the is set to the method indicated by 
the message index m. 

pObj is not necessarily the precise object which receives the message. 



Parameter - Description 



m 



pCls 
pObj 



pBlk 



Pointer to a structure of type Class. 

Pointer to a structure of type Object The object 

receiving the message. 

The selector index. 

Pointer to a structure of type Block. Optional 
parameters to pass to the method. 
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CIsSendObjectMessageReturnInt 



Notes (cont) 

pObJ is offset by an amount determined by the message first. Therefore, a 
subobject or superobject of pObJ may be the ultimate receiver of the message. 

(The message number must be greater than or equal to zero, and less than the 
nimiber of messages.] 

See Also 

ClsSendMessage. ClsSendMessageRetPtr 

Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
CIsSendObjectMessageReturnInt function. 
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CIsSendObjectMessageReturnRr 



Summary 

#include "cobjects.h" 
#lnclude "clsmac.h" 



Void asSendObjectMessageRetumFtr( pQs, pObi m, pBlk ) 

PCLS pCls; 

POBJ pObJ: 

Mediumint m; 

PBLK pBlk; 



Public Function 

Purpose 

The ClsSendObjectMessageRetPtr function sends the message indicated by the 
selector index m to the Object pObj which is an object of Class pCls. 
Parameters are sent to the method through the Block pBlk. The return value is 
the return value from the method called. 



Parameter - Description 



pCls - Pointer to a structure of type Class. 

pObj - Pointer to a structure of type Object. The object 

receiving the message, 
m - The selector index. 

pBlk - Pointer to a structure of type Block. Optional 
parameters to pass to the method. 



range: m must be in the range [0:N-1] where N is the nimiber of messages pCls 
responds to. 

Return Value 

No return value 

Notes 

If pBlk has a method set it is ignored and the is set to the method indicated by 
the message index m. 

pObj is not necessarily the precise object which receives the message. pObj is 
offset by an amount determined by the message first. Therefore, 
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CIsSendObjectMessageReturnRr 



Notes (cont) 

a subobject or superobject of pObj may be the ultimate receiver of the message. 

(The message number must be greater than or equal to zero, and less than the 
number of messages.] 

See Also 

ClsSendMessage, ClsSendMessageRetPtr 
Example 

Please refer to class test procedure TSTCLS.C for an example of the use of the 
ClsSendObjectMessageRetumPtr function. 
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Class 



Hiis page is intentionaUy left blank 
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Class Reference for List 



Structure Name: 
Abbreviation: 
Class Type: 



List 
Dil 

Inlieritabie class 



DIIAppend 



Summary 

#lnclude "cobjects.h" 
#include "dllmac.h" 

Void DllAppend( pDU, pLcl, pLelApp ) 

POLL pDU: 
PLEL pLel; 
PLEL pLelApp; 

Public Function 

Purpose 

The DIIAppend function links the ListElement pLelApp, succeeding the 
ListElement pLei, to the Ust pDll. If the ListElement pLel is NULL then pLelApp 
is linked to the List pDU as the last list element. 

Parameter - Description 



pDll - Pointer to a structure of type List The list being linked 
to. 

pLel - Pointer to a structure of type ListElement pLelApp will 

be linked as the successor of this list element. 

pLelApp - Pointer to a structure of type ListElement This is the 
list element to link to the list. 

Return Value 

No return value 

Notes 

pLelApp cannot already belong to a list. pLel must already be linked to pDU. 

See Also 

DllAppendLast, Dlllnsert, DlllnsertFirst 
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DIIAppend 



Diagram 

Before After 




CD ■ Element to Append 

pLelApp 
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DIlAppendLast 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 

Void DUAppendLast(pDU,pLel) 

PDLL pDU; 
PLEL pLel: 

Public Function 

A macro Is available for this function 

Purpose 

The DIlAppendLast function links the UstElement pLel to the List pDll as the 
last list element. 

Parameter - Description 



pDll - Pointer to a structiare of type Ust The list being linked 
to. 

pLel - Pointer to a structure of type ListElement. The list 
element will be linked as the last list element. 

Return Value 

No return value 

Notes 

pLel cannot already belong to a Ust. 
See Aiso 

DllAppend, Dlllnsert, DllInsertFirst 
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DIIAppendLast 

Diagram 
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DIIAsObJ 



Summary 

#lnclude "cobjects.h" 
#lnclude "dllmac.h" 

POBJ DUAsObj(pDU) 
PDLL pDU: 

Private Function 

A macro is available for this function 

Purpose 

The DllAsObj function returns a pointer to the Object structure contained by 
the List pDll. 

Parameter - Description 

pDU - Pointer to a structure of type List 
Return Value 

The return value from the DllAsObj function is a pointer to the Object structure 
contained by the List class. 

Notes 

The Object pointer can be used to send a message to the client of the List. 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DUAsObJ function. 
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DllClear 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 

Void DUaear(pDll) 
PDLL pDU; 

Public Function 

Purpose 

The DllClear function cuts all list elements (if any) from the List pDll. The list 
will be in the same state as it was after being initialized. 

Parameter - Description 

pDll - Pointer to a structure of type List 
Return Value 
No return value 

Example 

Please refer to class test procedure TSTDLL.C,TSTLEL.C for an example of the 
use of the DllClear function. 
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DllCut 



Summary 

#Include "cobjects.h" 
#lnclude "dllmac.h" 

Void DUCuK pDU, pLcl ) 

PDLL pDU; 
PLEL pLel; 

Public Function 

Purpose 

The DllCut function unlinks the ListElement pLel from from the List pDll. 

Parameter • Description 

pDll - Pointer to a structure of type List This is the list being 
modified. 

pLel - Pointer to a structure of type UstElement. This is the 
list element to cut. 

Return Value 

No return value 
Notes 

[pLel must be in the list pDll.] 

See Also 

DllClear, DUCutRange, DllPasteRangeAfter, DllPasteRangeBefore, 
DUPasteRangeFirst, DUPasteRangeLast 
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DllCut 
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DllCutChildren 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 

Void DUCutChildren(pDU) 
PDLL pDU; 

PubUc Function 

Purpose 

The DllCutChildren function cuts all list elements (if any) from the List pDll. 
The list will be in the same state as it was after being initialized. 

Parameter - Description 

pDll - Pointer to a structure of type List The list being 

cleared. 

Return Value 

No return value 

Example 

Please refer to class test procedure TSTDLL.C,TSTLEL.C for an example of the 
use of the DllCutChildren function. 
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DIICutRange 



Summary 

#inclucle "cobjects.h' 
#lnclude "dllmac.h" 



Void 
POLL 
PLEL 
PLEL 



DUCutRange( pDU, pUlBeg, pUlEnd ) 

pDU: 

pLelBeg; 

pLelEnd; 



Public Function 



Purpose 



The DIICutRange function unlinks a range of UstElements pLelBeg through 
pLelEnd from the List pDll. The list element preceding pLelBeg will be linked to 
the successor list element of pLelEnd. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See List 
class section on range demiition for more details. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list being 
cut. 

pLelBeg - Pointer to a structure of type ListElement. This is the 

beginning list element to cut. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

ending list element to cut. 

Return Value 

No return value 



The list elements that are cut remain linked but do not belong to any list. All 
elements (inclusive) between pLelBeg and pLelEnd are unlinked from pDU. 

(If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.] 

IpLelBeg must be in the list pDll.J 



Notes 



Dll - 1 1 



DIICutRange 



See Also 

DllClear, DUCut, DllPasteRangeAfter, DllPasteRangeBefore, DllPasteRangeFirst, 
DllPasteRangeLast 

Diagram 



Before After 
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DIIDelnit 



Summary 

#lnclude "cobjects.h" 
#lnclude "dllmac.h" 

Void DUDeInit( pDU ) 

PDLL pDU; 

Public Function 

Purpose 

The DIIDelnit function deinitializes the List object. The DIIDelnit function 
should be the last function called when using the List class. 

Parameter - Description 

pDll - Pointer to a structure of type List 

Return Value 

No return value 
Notes 

The first function to call when using the List class is DUInit. 
[pDll cannot have any list elements.] 
See Also 

DUDestroy. Dlllnit. DllClear 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIIDelnit function. 
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DIIDestroy 



Summary 

#lnclude "cobjects.h" 
#lnclude "dllmac.h" 

Void DUDestroy( pDU ) 

POLL pDU: 

Public Function 

Purpose 

The DUDestroy function deallocates the memory used by the object and 
deinitializes the List object. The List pDll should not be referenced after this 
function call since its memory will have been deallocated. 

Any elements in the list will be imlinked before destrojring the object. 

Parameter - Description 

pDll - Pointer to a structure of type List 

Return Value 

No return value 
Notes 

[pDll must not have a sub-object.] 

See Also 

DllDelnit, DUInit 

Example 

Please refer to class test procedure TSTDLL.C,TSTLEL.C for an example of the 
use of the DIIDestroy function. 
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DIIGetClient 



Summary 

#lnclude "cobjects.h" 
#include "dllmac.h" 

POBJ DUGetaient(pDU, offset) 

PDLL pDU: 
Mediumint offset; 

Public Function 

A macro Is available for this function 

Purpose 

The DIIGetClient function returns the client pointer of the List pDll. 

Parameter - Description 



pDll - Pointer to a structure of lype List 
offset - Hie distance in bytes between the List pDU and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. ® 

Return Value 

The return value from the DIIGetClient function is the client pointer of the List 
pDll. 



Example 

Please refer to class test procedure TSTDLL.C,TSTLEL.C for an example of the 
use of the DIIGetClient function. 
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DIIGetFirst 



Summary 

#include "cobjects.h' 
#inclu<le "dllmac.h" 



PLEL 
PDLL 



DllGetFirst(pDll) 
pDU; 



Private Function 

A macro Is available for this function 



Putpose 



The DIIGetFirst function returns a pointer to the first UstElement in the List 
pDll or NULL If it is empty. 



Return Value 

The return value from the DIIGetFirst function is a pointer to a structure of 
type ListElement. The list element is the first in the List pDll or NULL if the list 
is empty. 

See Also 

DUGetLast, DUGetNth 

Example 

Please refer to class test procedure TSTDLL.C,TSTLEL.C for an example of the 
use of the DIIGetFirst function. 



Parameter - Description 



pDU 



Pointer to a structure of type List 
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DIIGetLast 



Summary 

#lnclude "cobjects.h' 
#include "dllmac.h" 



PLEL 
PDLL 



DllGetLast(pDU) 
pDU: 



Private Function 

A macro is available for this function 



Purpose 



The DIIGetLast function returns a pointer to the last ListElement in the List 
pDll or NULL if it is empty. 

Parameter - Description 



Return Value 

The return value from the DIIGetLast function is a pointer to a structure of type 
ListElement The list element is the last list element in the List pDll or NULL if 
the list is empty. 

See Also 

DllGetFirst. DllGetNth 



Please refer to class test procedure TSTDLL.C,TSTLEL.C for an example of the 
use of the DIIGetLast function. 



pDU 



Pointer to a structure of type List. 



Example 
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DIIGetNth 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 

PLEL DllGetNth(pDU, index) 

PDLL pDU; 
Mediumlnt Index; 

Private Function 

Purpose 

The DIIGetNth function returns a pointer to the Nth LisfElemsnt in the List 
pDU. 

Parameter - Description 



pDll - Pointer to a structure of type List 
index - Index to list element in list. [O-END] 

index: 0 is the first list element index in the list and END is the last 
consecutively numbered list element index. 

Return Value 

The return value from the DIIGetNth function is a pointer to a structure of type 
UstElernent The list element is the indexed member of the list. 

See Also 

DUGetFirst, DllGetLast 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIIGetNth function. 
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DIIGetSize 



Summary 

#Include "cobjects.h" 
#include "dllmac.h" 

Medivunint DUGetSize( pDU ) 
PDLL pDU; 

Public Function 

Purpose 

The DllGetSlze function returns the number of list elements in the List pDll. 

Parameter - Description 

pDll - Pointer to a structure of type Ust 
Return Value 

The return value from the DIIGetSize function is the the number of list 
elements in the List pDU. 

Exampie 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIIGetSize function. 
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Dlllnit 



Summary 

#include "cobjects.h" 
#include "dUmac.h" 

Void DUInit(pDU) 
PDLL pDU; 

Public Function 

Purpose 

The Dlllnit function initializes the List object. The Dlllnit function should be the 
first function called when using the List class. 

Parameter - Description 

pDll - Pointer to a structure of type List 

Return Value 

No return value 

Notes 

The last function to call when using the List class is DllDelnit. 

See Also 

DllDelnit. DllDestroy 

Example 

Please refer to class test procedure TSTDLL.C,TSTLEL.C for an example of the 
use of the Dlllnit fiinction. 
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Dlllnsert 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 



Void DUInsert(pDll,pLel,pLelIns) 

PDLL pDU: 

PLEL pLel; 

PLEL pLellns; 



Public Function 

Purpose 

The Dlllnsert function links the UstEtement pLellns, preceding the ListElement 
pLel, to the Ust pDll. 

If the ListElement pLel is NULL then pLellns is inserted to be first in the List 
pDU. 

Parameter - Description 



pDll - Pointer to a structure of type List The list being 

modified. 

pLel - Pointer to a structure of type ListElement. pLellns will 
be linked as the predecessor to this list element. 

pLellns - Pointer to a structure of type ListElement. This is the 
list element to link to the Ust. 

Return Value 

No return value 

Notes 

pLellns cannot already belong to a list. 

pLel, if not NULL, must already be linked to pDll. 

See Also 

DUAppend, DllAppendLast, DUInsertFirst 
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Dlllnsert 



Diagram 
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DlllnsertFirst 



Summary 

#incl'ide "cobjects.h" 
#lnclude "dllmac.h" 

Void DUInsertFirsK pDU, pLel ) 

POLL pDU; 
PLEL pLel; 

Public Function 

A macro is available for this function 

Purpose 

The DlllnsertFirst fianction links the ListElement pLel as the first list element of 
theLtetpDll. 

Parameter - Description 



pDll - Pointer to a structure of type List The list being 
modified. 

pLel - Pointer to a structure of type ListElement The list 
element will be the first in the list. 

Return Value 

No return value 
Notes 

pLel cannot already belong to a list. 

See Also 

DllAppend, DllAppendLast, Dlllnsert 
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DlllnsertFirst 



Diagram 

Before After 
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DlllsEmpty 



Summary 

#includc "cobjects.h" 
#include "dllmac.h" 

Bool DllIsEinpty( pDll ) 

PDLL pDU; 

Public Function 

A macro Is available for this function 

Purpose 

The DlllsEmpty function determines if the Ust pDll has any elements. 

Parameter - Description 

pDll - Pointer to a structure of type Ust 

Return Value 

The return value from the DlllsEmpty is True if the List pDll contains no list 
elements or False if it does. 

Example 

Please refer to class test procedure TSTDLL.C,TSTL£L.C for an example of the 
use of the DlllsEmpty function. 
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DIILelClientCount 



Summary 

#lnclude "cobjects.h" 
#lnclude "dllmac.h" 

Mediumint DULelQientCounti pDU, offset, pBlk ) 
POLL pDU; 
Mediumint offset: 
PBLK pBlk; 

Public Function 

Purpose 

The DIILelClientCount function returns the number of times that a LtstElement 
client function returns non-zero. The entire List pDll is walked in a forward 
direction with the client function being called once for each list element visited. 

The Block pBlk contains the client function and an optional list of arguments. 
The client function must return a Mediumint value. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list to 
walk. • 

offset - The distance in bytes between a ListElement and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function, 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the DIILelClientCount function is the number of times 
the ListElement client function returns non-zero. 
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DIILelClientCount 
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DIILelClientFind 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 



F06J DULeiaientFind(pDU, offset, pBlk) 

PDLL pDU: 

Mediumint offset; 

FBLK pBlk: 



Public Function 

Purpose 

The DIILelClientFind function walks the List pDU and calls a ListElement client 
ftinction for each list element. The list is walked in a forward direction. The 
function terminates when the client function returns True or the end of the list 
is reached. If a True value is returned, the client pointer of the list element is 
returned, otherwise NULL is returned. 

The Block pBlk contains the client function and an optional list of arguments. 
The client function must return a boolean (True/Flase) value. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list to 

walk. 

offset - The distance in bytes between a ListElement and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the DIILelClientFind function is a pointer to the client of 
the first list element for which the client fijnction returns True. Otherwise 
NULL is returned. 
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DIILelClientFind 



Diagram 
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DIILelClientFirst 



Summary 

#lnclude "cobjects.h" 
#include "dllmac.h" 

POBJ DULeiaientFirsKpDU, offset) 

PDLL pDU: 
Mediumlnt offset; 

Public Function 

A macro Is available for this function 

Purpose 

The DIILelClientFirst returns the client pointer of the first ListElement in the 
List pDll. 

Parameter - Description 



pDU - Pointer to a structure of type List 
offset - The distance in b)rtes between a ListElement and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the DIILelClientFirst function is a pointer to the client of 
the first list element in the List pDll. If the list is empty the function will return 
NULL. 

See Also 

DllLelCllentLast 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIILelClientFirst function. 
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DIILelClientGetNth 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 

POBJ DUUiaientGetNth( pDU, offset, index ) 

POLL pDU; 
Mediumlnt offset: 
Mediumint index; 

Public Function 

Purpose 

The DIILelClientGetNth function returns the client pointer of the Nth 
UstElement in the List pDll. 

Parameter - Description 



pDll - Pointer to a structure of type List 

ofifset - The distance in bytes between a ListElement and it's 

client pointer. The value must be 0 or negative, 
index - Index to list element in list. [0-END] 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

index: 0 is the first list element index in the list and END is the last 
consecutively numbered list element index. 

Return Value 

The return value from the DIILelClientGetNth function is the client pointer of 
the indexed list element in the List pDll. If the list is empty the function will 
return NULL. 

See Aiso 

DllGetNth 
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DIILelClientGetNth 
Example 

Please refer to class test procedure TSTDLL.C,TSTLEL.C for an example of the 
use of the DIILelClientGetNth function. 
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DIILelClientLast 



Summary 

#include "cobjects.h* 
#include "dllmac.h" 



POBJ 

PDLL 



DULelQientLasK pDU, offset ) 
pDU: 



Public Function 

A macro Is available for this function 



Purpose 



The DIILelClientLast function returns the client pointer of the last ListElement 
in the List pDU. 



offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the DIILelClientLast function is a pointer to the client of 
the last list element in the Ust pDll. If the list is empty the function will return 
NULL. 

See Also 

DllLelCUentFirst 

Example 

Please refer to class test procedure TSTDLL.C.TSTLEL.C for an example of the 
use of the DIILelClientLast function. 



Parameter - Description 



pDll 
offset 



Pointer to a structure of type List. 

The distance in bytes between a ListElement and it's 

client pointer. The value must be 0 or negative. 
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DIILelClientVisitBwd 



Summary 

#include "cobjccts.h" 
#include "dllmac.h" 



Void DULeiaientVisitBwd( pDU, offset, pBlk ) 

POLL pDU: 

Mediumint - offset: 

PBLK pBlk; 



Public Function 

Purpose 

The DIILelClientVisitBwd function walks the entire List pDll and calls a 
UstElement client function for each list element. The list is walked in a 
backward direction (last to fbrst). 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pDll - Pointer to a structure of type List. This is the list to 

walk. 

offset - The distance in bytes between a ListElement and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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DIILelClientVisitBwd 



See Also 

DULelCUentVisitFwd 

Diagram 



First Element 
to Visit 




Tallc all Elements 
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DIILelClientVisitFwd 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 



Void DUUiaientVisitFwd( pDU, offset, pBIk ) 

POLL pDU: 

Mediumint offset: 

PBLK pBlk: 



Public Function 

Purpose 

The DIILelClientVisitFwd function walks the entire List pDll and calls a 
ListElement client function for each list element. The list is walked in a forward 
direction. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list to 
walk. 

offset - The distance in bytes between a ListElement and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 
No return value 
Notes 

The client function may return a value but it is ignored. 
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DIILelCiientVisitFwd 

See Also 

DULelCUentVlsitBwd 

Diagram 



Last Element 
to Visit 




fallc all Dements 
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DIINotifyCutRange 



Summary 

#include "cobjects.h' 
#lnclude "dllmach" 



Void 
PDLL 
PLEL 
PLEL 



DUNotifyCutRange( pDll, pLelBeg, pLelEnd ) 

pDU: 

pLelBeg: 

pLelEnd; 



Friend Function 



Purpose 



The DIINotifyCutRange is called by the ListElement class to notify the List that 
elements were cut. 

Return Value 

No return value 



This is a function is only to be used by the UstElement class. 

See Also 

DllNotifyPasteRange 

Example 

Please refer to class test procedure TSTDLL.C,TSTLEL.C for an example of the 
use of the DIINotifyCutRange function. 



Notes 
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DIINotifyPasteRange 



Summary 

#include "cobjects.h" 
#lnclude "dllmac.h" 



Void 
PDLL 
PLEL 
PLEL 




Friend Function 



Purpose 



The DIINotifyPasteRange is called by the ListElement class to notify the List that 
elements were pasted. 

Return Value 

No return value 



This is a function is only to be used by the ListElement class. 
See Also 

DllNotifyCutRange 

Example 

Please refer to class test procedure TSTDLL.C,TSTLEL.C for an example of the 
use of the DIINotifyPasteRange function. 



Notes 
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DIIPasteRangeAfter 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 



Void DllPasteRangeAfter( pDU, pLel, pLelBeg, pLelEnd ) 

PDLL pDU; 

PLEL pLel; 

PLEL pLelBeg: 

PLEL pLelEnd: 



Public Function 

Purpose 

The DIIPasteRangeAfter function links a range of ListElements pLelBeg through 
pLelEnd to the List pDU as the succeeding list elements of the UstElement pLel. 
If the ListElement pLel is NULL then the ListElements pLelBeg through pLelEnd 
are linked to the List pDll as the last elements. 

The list element range must have been previously cut from a list. 

A range of list elements is defined as a beginning list element and an ending 
list element. The be^nning element can equal the ending element. See List 
class section on range definition for more details. 

Parameter - Description 



pDU - Pointer to a structure of type List. This is the list to 
modify. 

pLel - Pointer to a structure of type ListElement. pLelBeg 
throu^ pLelEnd will be linked as the successors of 
this list element. 

pLelBeg - Pointer to a structure of type ListElement. This is the 

first list element to link to the list. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

last list element to link to the list. 

Return Value 

No return value 
Notes 

The pLelBeg must have a set of successors one of which is pLelEnd. 
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DIIPasteRangeAfter 



Notes (cont) 

[If pLelBeg does nnt equal pLelEnd then pLelBeg must precede pLelEnd.] 
[pLelBeg must not already be in a list.] 
[pLel must be in the list pDll.] 

See Also 

DllClear. DllCut, DUCutRange, DllPasteRangeBefore, DllPasteRangeFirst, 
DllPasteRangeLast 

Diagram 



Before 



After 




pLelBeg 




pLelEnd 



Range of Elements to Paste 
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DIIPasteRangeBefore 



Summary 

#include "cobjects.h" 
#include "dllmac.h" 



Void DllFasteRangeBefore( pDll, pLel, pLelBeg, pLelEnd ) 

PDLL pDU: 

PLEL pLel: 

PLEL pLelBeg; 

PLEL pLelEnd; 



Public Functloii 

Purpose 

The DIIPasteRangeBefore function links a range of UstElements pLelBeg 
through pLelEnd to the Ust pDll as the precedfing list elements of the 
ListElement pLel. If the UstElement pLel is NULL then the ListElements pLelBeg 
throu^ pLelEnd are linked to the Ust pDU as the first elements. 

Hie list element range must have been previously cut from a list. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See List 
class section on range definition for more details. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list to 
modify. 

pLel - Pointer to a structure of type ListElement pLelBeg 
throu^ pLelEnd will be linked as the predecessors of 
this list element. 

pLelBeg - Pointer to a structure of type ListElement. This is the 

first list element to link to the list. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

last list element to link to the list. 

Return Value 

No return value 
Notes 

The pLelBeg must have a set of successors one of which is pLelEnd. 
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DIIPasteRangeBefore 



Notes (cont) 

[If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.] 
[pLelBeg must not already be in a list.] 
(pLel must be In the list pDn.] 
See Also 

DUClear, DllCut, DllCutRange, DllPasteRangeAfter, DllPasteRangeFirst, 
DllPasteRangeLast 

Diagram 

Before After 
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DIIPasteRangeFirst 



Summary 

#include "cobjects.h' 
#include "dllmac.h" 



Void 
POLL 
PLEL 
PLEL 



DllPasteRangeFirsK pDll, pLelBeg, pLelEnd ) 

pDU: 

pLelBeg; 

pLelEnd; 



Public Function 

A macro Is available for this function 

Purpose 

The DIIPasteRangeFirst function links a range of ListElements pLelBeg through 
pLelEnd to the Ust pDll as the first list elements of the list. 

The list element range must have been previously cut from a list. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See List 
class section on range definition for more details. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list to 
modify. 

pLelBeg - Pointer to a structure of type ListElement This is the 

first list element to link to tlie Ust. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

last list element to link to the list. 

Return Vaiue 

No return value 



pLelBeg through pLelEnd cannot currentty belong to a list. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd. 

The pLelBeg must have a set of successors one of which is pLelEnd. 



Notes 
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DIlPasteRangeFirst 



Notes (com) 

pLel must be linked to the list. 

See Also 

DUClear, DllCut. DUCutRange. DIlPasteRangeAfter, DllPasteRangeBefore, 
DllPasteRangeLast 



Diagram 



Before 



After 




Jp Cp <X> Range of Elements to P&ste 

pLelBeg ^^--^^^--^pLelEnd 
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DIIPasteRangeLast 



Summary 

#include "cobjects.h' 
#include "dllmach" 



II 



Void 
PDLL 
PLEL 
PLEL 



DllFasteRangeLast( pDU, pLelBeg, pLelEnd ) 

pDU: 

pLelBeg; 

pLelEnd; 



Public Function 

A macro Is available for this function 



Purpose 



The DIIPasteRangeLast function links a range of ListElements pLelBeg through 
pLelEnd to the Ust pDll as the last list elements of the list. 

The list element range must have been previously cut from a list. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See List 
class section on range demiition for more details. 

Parameter - Description 



pDll - Pointer to a structure of type List This is the list to 

modify. 

pLelBeg - Pointer to a structure of type ListElement. This is the 

first list element to link to the list. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

last Ust element to link to me list. 

Return Value 

No return value 



pLelBeg through pLelEnd carmot currently belong to a list. 

If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd. 

The pLelBeg must have a set of successors one of which is pLelEnd. 



Notes 
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DIIPasteRangeLast 



Notes (cont) 

pLel must be linked to the list. 

See Also 

DllClear, DllCut, DIlCutRange. DllPasteRangeAfter. DllPasteRangeBefore, 
DllPasteRangeFlrst 

Diagram 

Before After 




Cp^P® Range of Elements to Paste 

pLelBeg^^--^^^--^pLelEnd 
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DIISendDestroy 



Summary 

#include "cobjects.h" 
#include "dllmach" 

Void DllSendDestroyCpDll) 
PDLL pDU; 

Public Function 

Purpose 

Hie DIISendDestroy function sends a message to the client of the List pDU 
asking it to destroy the List The Ust client function wiU receive this message 
and should destroy the list element. This message function shotild be included 
in the List client message array. 

Return Value 

No return value 



Example 

Please refer to class test procedure TSTDLL.C,TSTLEL.C for an example of the 
use of the DIISendDestroy function. 
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Class Reference for DynamicArray 

Structure Name: DynamicArray 
Abbreviation: Dpa 
Class Type: Primitive 
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DpaAppend 

Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Meditunlnt DpaAppend( pDpa, gp ) 



GenerlcPtr gp; 
Public Function 

Purpose 

The DpaAppend function appends the GenericPointer gp to be last in the 
DynamicArray pDpa. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 
gp - GenericPointer to be appended to the array. 

Return Value 

The return value from the DpaAppend function is the size of the array after the 
GenericPointer gp has been appended. 



This function differs from the DpaExpand function in that it assigns a 
GenericPointer to the new array element whereas DpaE^and opens up the 
array and the caller is requirea to assign values to the new elements with the 
DpaSetNth function. 

The array is ocpanded if needed. 

See Also 

DpaDelete, DpaExpand, DpaShiftDown, DpaShiftUp 



PDPA 




Notes 



Dpo-2 



DpaAppend 



Diagram 



Before 

8 elements 

pDpa 




□ 



c3> 



pDpa 



After 

9 elements 



GenericPointer to Append 



J 



END 
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DpaClear 



Summary 

#lnclude "cobjects.h' 
#include "dpamac.h' 



ft 



Void 
PDPA 



DpaOeai( pDpa ) 
pDpa; 



Public Function 



Purpose 



The DpaClear function sets the array to its initial state and sets the size of the 
array to 0. 

Parameter - Description 



Return Value 

No return value 

Example 

Please refer to class test procedure TSTDPA.C for an example of the use of the 
DpaClear ftinction. 



pDpa 



Pointer to a structure of type DynamicArray. The array 
being cleared. 
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DpaCount 



Summary 

#lnclude "cobjects.h" 
#lnclude "dpamac.h" 

Meditunint DpaCotintC pDpa, pBlk ) 
PDPA pupa; 
PBLK pBUc; 

Public Function 

Purpose 

The DpaCount function returns the number of times that a GenericPointer 
function retums a True value. The entire DynamicArray pDpa is walked in a 
forward direction with the GenericPointer function being called once for each 
element visited. 

The Blocfc pBlk contains the GenericPointer function and an optional list of 
arguments. The function must return a boolean (IVue/False) value. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 
the array to walk. 

pBlk - Pointer to structure of type Block which contains the 
function to call and any optional parameters to be sent 
to the function. 

Return Value 

The retum value from the DpaCount function is the number of times the 
GenericPointer fimction retums True. 

See Also 

DpaCountRange, DpaFind, DpaFindRangeFwd, DpaFindRangeBwd 
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DpaCount 



Diagram 



10 elements 



pDpa 
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0 END 
Visit ail Elements 



Element \^ted and Order 
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DpaCountRange 



Summary 

#lnclude "cobjects-h" 
#lnclude "dpamac.h" 



Mediumint DpaCotintRange( pDpa, beg^ end, pBlk ) 

PDPA pDpa; 

Mediumint beg; 

Mediumint end; 

PBLK pBlk; 



Public Fimction 

Purpose 

The DpaCountRange function returns the nimiber of times that a 
GenerlcPointer function returns a True value. The DyncunicArray pDpa is 
walked for a range of elements beg through end in a forward direction with the 
GenericPointer function being called once for each element visited. 

The Block pBlk contains the GenericPointer function and an optional list of 
arguments- The function must retum a boolean (True/False) value- 

A range of array elements is defined as a beginning element and an ending 
element. The beginning element can equal the ending element. See section on 
range definition for more details. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 

the array to walk, 
beg - Index to beginning of traverse. [0-END] 

end - Index to end of traverse. [0-END] 

pBlk - Pointer to structure of type Block which contains the 
function to call and any optional parameters to be sent 
to the function. 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

Return Value 

The retum value from the DpaCountRange function is the number of times the 
GenericPointer ftinction returns True for a range of array elements. 

Notes 
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DpaCountRange 

Notes (cont) 

[The index beg must be in the range [0-END].] 
(The index end must be in the range [0-END].] 
P3eg must be less than or equal to end.] 

See Also 

DpaCount, DpaFind, DpaFindRangeFwd, DpaFindRangeBwd 

Diagram 



10 elements 



pDpa 



Beginning 
of Walk 




Ending 
of Walk 



El Element Visited and Order 
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DpaDelnit 



Summary 

#include "cobjects.h' 
#include "dpamac.h* 



Void 
PDPA 



DpaDeInit( pDpa ) 
pDpa; 



Public Function 



Purpose 



The DpaDelnit function deinitlalizes the DynamicAnray object. The DpaDelnit 
function shoiild be the last function called when using the DynamicArray class. 
The memory used by the array is deallocated. 



Return Value 

No return value 

Notes 

The first function to call when using the DynamicArray class is Dpalnit. 

See Also 

DpaDestroy, Dpalnit, DpaNew 
Example 

Please refer to class test procedure TSTDPA.C for an example of the use of the 
DpaDelnit function. 



Parameter - Description 



pDpa 



Pointer to a structure of lype I)ynamicATTay. 
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DpaDelete 



Summary 

#include "cobjects.h" 
#lnclude "dpamac.h" 

Void DpaDelete( pDpa, beg^ n ) 

PDPA pDpa; 

Mediumint beg; 

Mediumlnt n; 

Public Function 

Purpose 

The DpaDelete function deletes a region of array elements, starting with beg for 
a count of n times, from the DynamicArray pDpa. 

A region of array elements is defined as a beginning element and an count from 
the Deginning element. The count cannot be less than 1, See section on region 
definition for more details. 



Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. 

beg - Index to beginning of the delete. [O-END] 

n - Number of elements to delete from array. 1 1 -SIZE] 



index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

count: SIZE is the number of elements in the array. 

Return Value 

No retum value 

Notes 

The array size is reduced by the number of elements that are deleted. 
[The index beg must be in the range [O-END].] 
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DpaDelete 



Notes (cont) 

[(beg + n) must be less than or equal to the size of the anay.] 

See Also 

DpaAppend, DpaExpand, DpaShiftDown, DpaShiftUp 

Diagram 



pDpa 



Before 

9 elements 



i3> 



After 

6 elemts 

pDpa 



beg " 3 

Beginning 
of Delete 
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Number 
to Delete 
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Dpa Destroy 

Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Void DpaDestroy( pDpa ) 

PDPA pDpa; 

Public Function 

Purpose 

The DpaDestroy function deallocates the memory used by the object and 
deinitializes the DynamicArray object. The DynamicArray pDpa should not be 
referenced after this function call since its memory will have been deallocated. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 

Return Value 

No return value 

See Also 

DpaDelnit, Dpalnit, DpaNew 

Example 

Please refer to class test procedure TSTDPA.C for an example of the use of the 
DpaDestroy function. 
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DpaExpand 



Summary 

#lnclude "cobjects.h" 
#include "dpamac.h" 



Void DpaExpand( pDpa, beg, n ) 

PDPA pDpa: 

Mediumint beg; 

Mediumint n; 



Public Function 

Purpose 

The DpaExpand function expands the DynamicArray pDpa by inserting NULL 
values into a region of array elements starting with beg for a count of n times. 

A region of array elements is defined as a beginning element and an count from 
the beginning element. The count cannot be less than 1. See section on region 
definition for more details. 

Parameter - Description 



EDpa - Pointer to a structure of type DynamicArray. 
eg - Index to beginning of the paste. [0-END] 

n - Number of elements to paste into array. [l-SIZE] 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

count: SIZE is the number of elements in the array. 

Return Value 

No return value 

Notes 

The size of the array is expanded, if required, to acconmiodate the additional 
elements. 

This function differs firom the DpaAppend fianction in that 
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DpaExpand 



Notes (com) 



the caller is required to assign values to the new elementj with the DpaSetNth 
function. The DpaAppend fmiction assigns a GenerlcPointer value to the 
appended array element. 

At least one element will always be moved down the array, 
(beg must be in the range [0:DpaGetSize].] 
[n must be greater than zero.] 

See Also 

DpaAppend. DpaDelete, DpaShiftDown, DpaShiftUp 

Diagram 



Before 
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DpaFind 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Mediumlnt DpaFindC pDpa, pBlk ) 

PDPA pDpa; 
PBLK pBlk; 

Public Function 

Purpose 

The DpaFind function walks the DynamicArray pDpa and calls a 
GenericPointer function for each element visited. The array is walked in a 
forward direction. The function will terminate when the GenericPointer 
function retums True or the end of the array is reached. If a True value is 
retumed. the index of the array element is retumed. 

The Blocfc pBlk contains the GenericPointer function and an optional list of 
arguments- Hie function must retum a boolean fTrue/False) value. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 
the array to walk. 

pBlk - Pointer to structure of type Block which contains the 
function to call and any optional parameters to be sent 
to the function. 

Return Value 

The retum value from the DpaFind function is the index of the first array 
element for which the GenericPointer function retums True. If no function 
retums True then the retum value is -1. 

See Also 

DpaCount, DpaCountRange, DpaFindPtrBwd, DpaFindPtrFwd, 
DpaFindRangeFwd, DpaFindRangeBwd 



Dpa- 15 



DpaFind 



Diagram 
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DpaFindPtrBwd 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Mediumint E>paFindPtrBwd( pDpa, beg, gp ) 
PDPA pDpa; 
Mediumint beg; 
GenericPtr gp; 

Public Function 

Purpose 

The DpaFindPtrBwd ftinction walks the DynamicArray pDpa, starting at beg 
and ending at the first element of the array, and returns an index to the 
element for which the GenericPointer gp equals the GenerlcPointer of the 
element visited. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 

the array to walk, 
beg - Index to start of traverse, 

gp - GenericPointer to be compared. 

Return Value 

The return value from the DpaFindPtrBwd function is the index of the array 
element for which the GenericPointer of the element equals the GenericPointer 
gp. If no match is foimd the function returns -1. 

Notes 

(The Index beg must be in the range [O-END].) 

See Also 

DpaCount, DpaCountRange, DpaFind, DpaFindPtrFwd. DpaFindRangeFwd, 
DpaFindRangeBwd 
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DpaFindPtrBwd 



Diagram 
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DpaFindPtrFwd 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Mediumint E>paFindPtiFwd( pDpa, beg, gp ) 
PDPA pDpa; 
Mediumint beg; 
GenerlcPtr gp; 

Public Function 

Purpose 

The DpaFindPtrFwd function walks the DynamicArray pDpa, starting at beg 
and ending at the last element of the array, and returns an index to the 
element for which the GenerlcPointer gp equals the GenericPointer of the 
element visited. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 

the array to walk, 
beg - Index to start of traverse, 

gp - GenericPointer to be compared. 

Return Value 

The return value from the DpaFindPtrFwd function is the index of the array 
element for which the GenericPointer of the element equals the GenericPointer 
gp. If no match is found the function returns -1. 

Notes 

[The index beg must be in the range (O-END).] 

See Also 

DpaCount, DpaCountRange, DpaFind, DpaFindPtrBwd, DpaFindRangeFwd, 
DpaFindRangeBwd 
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DpaFindPtrFwd 



Diagram 
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DpaFindRangeBwd 



Summary 

#include "cobjects.h" 
#lnclude "dpamac.h" 

Mediumlnt ppaFindRangeBwd( pDpa, beg^ end, pBlk ) 
PDPA pDpa: 
Mediumlnt beg; 
Mediumlnt end; 
PBLK pBlk; 



Public Function 



Purpose 

The DpaFindRangeBwd function walks a range of array elements, beg through 
end, for the DynamicArray pDpa and calls a GenericPointer function Tor each 
element visited. The array is walked in a backward direction. The function will 
terminate when the GenericPointer function returns True or the end of the 
range is reached* If a Ttue value is returned, the index of the array element is 
returned. 



The Block pBlk contains the GenericPointer function and an optional list of 
arguments. The function must return a boolean (True/False) value. 

A range of array elements is defined as a beginning element and an ending 
element. The beginning element can equal the ending element. See section on 
range definition for more details. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 

the array to walk, 
beg - Index to beginning of traverse. [0-END] 

end - Index to end of traverse. [O-END] 

pBlk - Pointer to structure of type Block which contains the 
function to call and any optional parameters to be sent 
to the function. 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

Return Value 

The return value from the DpaFindRangeBwd function is the index to the first 
array element for which the GenericPointer function retums True. Otherwise -1 
is returned. 
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DpaFindRangeBwd 



Notes 

rrhe Index beg must be In the range [O-END].] 
[The index end must be In the range [O-ENDJ.] 
[beg must be less than or equal to end.] 

See Also 

DpaCount, DpaCountRange, DpaFind, DpaFindPtrBwd. DpaFindPtrFwd, 
DpaPlndRangeFwd 

Diagram 



I * 10 elements 

pDpa 




Walk the Array to Find Element 
F| Element Visited and Order 
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DpaFindRangeFwd 



Summary 

#include "cobjects.h" 
#include "dpamach" 



Mediumlnt DpaFmdRangeFwd( pDpa, beg, end, pBlk ) 

PDPA pDpa; 

Mediumlnt beg; 

Mediumlnt end; 

PBLK pBlk; 



Public Function 

Purpose 

The DpaFindRangeFwd function walks a range of array elements, beg through 
end, for the DynamicArray pDpa and calls a GenericPointer function for each 
element visited. The array is walked in a forward direction. The function will 
terminate when the GenericPointer function returns True or the end of the 
range is reached. If a Ttue value is returned, the index of the array element is 
returned. 

The Block pBlk contains the GenericPointer function and an optional list of 
arguments. The function must retum a boolean H^e/False) value. 

A range of array elements is defined as a beginning element and an ending 
element. The beginning element can equal the ending element. See section on 
range definition for more details. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 

the array to walk, 
beg - Index to beginning of traverse. [0-END] 

end - Index to end of traverse. [0-END] 

pBlk - Pointer to structure of type Block which contains the 
function to call and any optional parameters to be sent 
to the function. 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

Return Vaiue 

The retum value from the DpaFindRangeFwd function is the index to the first 
array element for which the GenericPointer function retums True. Otherwise -1 
is returned. 
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DpaFindRangeFwd 



Notes 

[The index beg must be in the range [0-END].] 
fThe index end must be in the range fO-END].! 
[beg must be less than or equal to end.] 

See Also 

DpaCount, DpaCountRange, DpaFind. DpaFindPtrBwd. DpaFindPtrFwd, 
DpaFindRangeBwd 



Diagram 



I * 10 elements 
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DpaGetNth 



Summary 

#Include "cobjects.h" 
#lnclude "dpamach" 

GenericPtr DpaGetNthC pDpa, n ) 
PDPA pDpa; 
Mediumint n; 

Public Function 

Purpose 

The DpaGetNth function returns the GenericPointer contained in the 
DynamicAitay pDpa at element index. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 
index - Index to array element. [O-END] 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

Return Value 

The return value from the DpaGetNth function is the GenericPointer contained 
in DynamicArray pDpa at element index. 

Notes 

[The index n must be. in the range (O-END].] 

See Also 

DpaGetLast DpaSetNth 
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DpaGetNth 



Diagram 
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DpaGetLast 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

GenericFtr ppaGetLast( pDpa ) 
PDPA pDpa; 

Public Function 

Purpose 

The DpaGetLast function returns the GenerlcPolnter contained in the 
DynamlcArray pDpa as the last element. 

Parameter - Description 

pDpa - Pointer to a structure of type DyrumdcArray. 

Return Value 

The return value from the DpaGetLast function is the GenericPointer contained 
in the last array element. 

Notes 

[The array must have at least one element.] 

See Aiso 

DpaGetNth, DpaSetNth 
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DpaGetLast 



Diagram 
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DpaGetSize 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Mediumint I>paGetSize( pDpa ) 
PDPA pDpa; 

Public Function 

Purpose 

The DpaGetSize function returns the size of the DynamicAnxiy pDpa. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 

Return Value 

The return value from the DpaGetSize function is the size of the array. 
See Also 

Dpalnit, DpaNew, DpaSetSize 
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DpaGetSize 

Diagram 
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1 



Dpalnit 



Summary 

#lnclude "cobjects.h" 
#Include "dpamac.h" 

Void Dpalnit( pDpa, s, i ) 

PDPA pDpa; 

Mediumint s; 

Mediumlnt i; 

Public Function 

Purpose 

The Dpalnit function initializes the DynamicArray object. The Dpalnit function 
should be the first function called when using the DynamicArray class. The 
initial size of the array s, and the increment size i for the array are passed. The 
increment size is used for e^roanding the array as demanded by appends or 
pastes. The memory required the array's initial size is allocated. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. 
s - Initial size of dynamic pointer array. 

1 - Increment size for expansion of array. 

Return Value 

No return value 

Notes 

The last function to call when using the DynamicArray class is DpaDelnit. 

[The increment must be greater than one.] 

[The initial size must be greater than or equal to zero.] 
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Dpalnit 



I 
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I 



See Also 

DpaDelnit DpaDestroy. DpaNew 

Example 

Please refer to class test procedure TSTDPA.C for an example of the use of the H 
Dpalnit function. ■ 
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DpaSetNth 



Summary 

#include "cobjects.h' 
#include "dpamac.h' 



Void 
PDPA 
Mediumint 
GenerlcPtr 



DjpaSetNth( pDpa, index, gp ) 

pDpa; 

index; 

gp: 



Public Function 



Purpose 



The DpaSetNth function assigns the GenericPointer gp to the DynamicArray 
pDpa at the element index. 

Parameter - Description 



index: 0 is the first element index in the array and END is the last 
consecutively nvmibered element index. 

Return Value 

No return value 

Notes 

(The index index must be in the range [0-END].l 

See Also 

DpaOetNth, DpaOetLast 



pDpa 
index 

gp 



Pointer to a structure of type DynamicArray. 
Index to element in array. 
GenericPointer to be assigned to element. 
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DpaSetNth 
Diagram 
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DpaSetRegionNull 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Void DpaSetRegionNulK pDpa, heg, n ) 

PDPA pDpa: 
Mediumint beg; 
Medlumlnt n; 

Public Function 

Purpose 

The DpaSetRegionNull walks a region of elements, starting with beg for a count 
of n times, for the DynamicArray pDpa and assigns a NULL value to each 
element visited. 

A re^on of array elements is defined as a beginning element and an count from 
the beginning element. TTie count cannot be less than 1. See section on region 
definition for more details. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 

beg - Index to start of traverse. [0-END] 

n - Number of elements to substitute NULL. [l-SIZE] 

index: 0 is the first element Index in the array and END is the last 
consecutively numbered element index. 

count: SIZE is the number of elements in the array. 

Return Value 

No return value 
Notes 

(The index beg must be in the range [0-ENDJ.] 

I(beg + n) must be less than or equal to the size of the £irray.] 
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DpaSetRegionNull 



Diagram 



I-* 9 elements 

pDpa 



aiDiBiiiiiiicii 



Beginning ■ _ „ 
of Region •"'e ~ " 



n » 3 




assign NULL 
to Elements 



Dpa-36 



DpaSetSize 



Summary 

#lnclude "cobjects.h" 
#lnclude "dpamac.h" 

Void DpaSetSize( pDpa, size ) 

PDPA pDpa: 
Medlumint size; 

Public Function 

Purpose 

The DpaSetSize function sets the new minimum size of the DynamicArray pDpa 
as a multiple of the increment size. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 
size - New size of the dynamic array. 

Return Value 

No return value 

Notes 

If the size of the array is reduced the elements are cut from the end of the 
array. 

If the size of the array is expanded then the additional NULL elements are 
appended to the end of the array. 

[The new size must be greater than or equal to zero.] 

See Aiso 

DpaGetSize, Dpalnit, DpaNew 

Example 

Please refer to class test procedure TSnrDPA.C for an example of the use of the 
DpaSetSize function. 



Dpa-37 



DpaShiftDown 



Summary 

#indude "cobjects.h" 
#include "dpamac.h" 

Void DpaShif tDown( pDpa, n ) 
PDPA pDpa; 
Mediumlnt n; 

Public Function 

Purpose 

The DpaShiftDown function shifts n elements down In the IXfrmrnicArray pDpa. 
Hie size of the DynamicAiTay pDpa is unchanged. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 
n - Number of elements to smrt down in array. 

Return Value 

No return value 
Notes 

{N must be greater than zero and less than the aray size.] 
See Also 

Dpa/^pend, DpaDelete, DpaExpand, DpaShiftUp 
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DpaShiftDown 



Diagram 
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DpaShiftUp 



Summary 

#lnclude "cobjects.h" 
#include "dpamac.h" 

Void ppaShiftUp(pDpa,n) 
PDPA pDpa: 
Mediumint n; 

Public Function 

Purpose 

The DpaShiftUp function shifts n elements up in the J^namicArray pDpa. The 
size 01 the DynamicArray pDpa is unchanged. 

Parameter - Description 

pDpa - Pointer to a structure of type DynamicArray. 
n - Number of elements to scroll up in array. 

Return Value 

No return value 

Notes 

[N must be greater than zero and less than the array size.] 
See Also 

Dpa^pend, DpaDelete, DpaExpand, DpaShiftDovni 
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DpaShiftUp 
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DpaVisit 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Void DpaVisit(pDpa,pBlk) 
PDPA pDpa; 
PBLK pBlk; 

Public Function 

Purpose 

The DpaVisit function walks the entire DynamicArray pDpa and calls a 
GenericPointer function for each element visited. The array is walked in a 
forward direction. 

The Block pBlk contains the GenericPointer function and an optional list of 
arguments. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 
the array to walk. 

pBlk - Pointer to structure of type Block which contains the 
function to call and any optional parameters to be sent 
to the function. 

Return Value 

No return value 

Notes 

The GenericPointer function may return a value but it is ignored. 

See Also 

DpaVlsitClient, DpaVisitRange, DpaVisitRegion, DpaVisitSel^dSuccessors 



Dpa - 42 



DpaVisit 



Diagram 
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DpaVisitClient 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 

Void DpaVisitaienK pDpa, offset, pBlk ) 

PDPA pDpa; 
Mediumint offset; 
PBLK pBlk; 

Public Function 

Purpose 

The DpaVisitClient function walks the entire DynamicArray pDpa and calls a 
client function for each element visited. The array is walked in a forward 
direction. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This Is 
the array to walk. 

ofTset - The distance in bytes between the DynamicArray pDpa 
and its client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The GenericPointer function may retum a value but it is ignored. 
If any of the elements of the array are NULL, they are not visited. 
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DpaVisitClient 



See Also 

DpaVisitRange, DpaVisitRegion, DpaVisitSelfAndSuccessors 

Diagram 
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DpaVisitRange 



Summary 

#include "cobjects.h" 
#include "dpamac.h" 



Void DpaVisitRange( pDpa, beg, end, pBlk ) 

PDPA pDpa; 

Mediumint beg; 

Mediumlnt end; 

PBLK pBlk; 



Public Function 

Purpose 

The DpaVisitRange function walks a range of array elements, beg through end, 
for the DynamicArray pDpa and calls a GenericPointer function for each 
element visited. The array is walked in a forward direction. 

The Block pBlk contains the function and an optional list of argimients. 

A range of array elements is defined as a beginning element and an ending 
element. The beginning element can equal the ending element. See section on 
range definition for more details. 

Parameter - Description 



pDpa - Pointer to a structure of type DyncimicArray. This is 

the array to walk, 
beg - Index to start of traverse. [O-END] 

end - Index to end of traverse. (O-END] 

pBlk - Pointer to structure of type Block which contains the 

function to call and any optional parameters to be sent 

to the function. 

index; 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

Return Value 

No return value 
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DpaVisitRange 



Notes 

The GenerlcPointer function may return a value but it is ignored. 
[The index beg must be in the range [0-END].] 
(The index end must be in the range [0-END].] 
(beg must be less than or equal to end.] 

See Also 

DpaVisit DpaVisitClient. DpaVisitRegion, DpaVisitSelfAndSuccessors 

Diagram 
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DpaVisitRegion 



Summary 

#include "cobjects.h" 
#lnclude "dpamac.h" 



Void DpaVisitRegion( pDpa, beg, n, pBlk ) 

PDPA pDpa: 

Mediumlnt beg; 

Mediiimint n; 

PBLK pBlk: 



Public Function 

Purpose 

Hie DpaVisitRegion fianction walks a region of array elements, starting with 
beg for a count of n times, for the DynamicArray pDpa and calls a 
GenericPointer function for each element visited. The array is walked in a 
forward direction. 

The Block pBlk contains the function and an optional list of arguments. 

A region of array elements is defined as a beginning element and an count from 
the beginning element. The count cannot be less than 1. See section on region 
definition for more details. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 

the array to walk, 
beg - Index to start of traverse. [O-END] 

n - Number of elements to traverse. [l-SIZE] 

pBlk - Pointer to structure of type Block which contains the 

function to call and any optional parameters to be sent 

to the function. 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

count: SI2SE is the nimiber of elements in the array. 

Return Value 

No return value 
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DpaVisitRegion 



Notes 

The GenerlcPolnter function may rettim a value but it is ignored. 

[The index beg must be in the range [0-END].] 

[(beg + n) must be less than or equal to the size of the array.] 

See Also 

DpaVisit, DpaVisitClient, DpaVisitRange, DpaVisitSel^dSuccessors 

Diagram 
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DpaVisitSelfAndSuccessors 



Summary 

#lnclude "cobjects-h" 
#include "dpamac.h" 

Void DpaVisitSelf AndSuccessois( pDpa, beg^ pBlk ) 
PDPA pDpa: 
Medlumlnt beg; 
PBLK pBlk; 

Public Function 

Purpose 

The DpaVisitSelfAndSuccessors function walks the DynamicArray pDpa and 
calls a GenericPointer function for each element visited. The array is walked in 
a forward direction (self to last) starting with the element beg. 

The Block pBlk contains the function and an optional list of arguments. 

Parameter - Description 



pDpa - Pointer to a structure of type DynamicArray. This is 

the array to walk, 
beg - Index to start of traverse. [0-END] 

pBlk - Pointer to structure of type Block which contains the 

function to call and any optional parameters to be sent 

to the function, 

index: 0 is the first element index in the array and END is the last 
consecutively numbered element index. 

Return Value 

No return value 

Notes 

The GenericPointer function may retum a value but it is ignored. 
[The index beg must be in the range [0-END].] 
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DpaVisitSelfAndSuccessors 



See Also 

DpaVisit, DpaVisitClient. DpaVisitRange, DpaVisitReglon 

Diagram 
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Class Reference for Edge 



Structure Name: 
Abbreviation: 
Class Type: 



Edge 
Edg 

Inheritable class 



EdgAsGrfLei 



Summary 

#include "cobjects.h' 
#include "edgmac.h" 



PLEL 
PEDG 



EdgAsGrfLeK pEdg ) 
pEdg; 



Friend Function 

A macro Is available for this function 



Putpose 



The EdgAsGrfLei function returns a pointer to the ListElement structure that is 
contained within the Edge pEdg. TTiis ListElement is used by the List within the 
Grcq)h object 



Return Value 

The return value from the EdgAsGrfLei function is a pointer to a ListElement 
structure. 



The ListElement pointer returned is contained as part of the Edge pEdg. This 
function is used by the Graph object. 

See Also 

EdgAsInLel. EdgAsOutLel 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgAsGrfLei function. 



Parameter - Description 



pEdg 



Pointer to a structure of type Edge. 



Notes 
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EdgAslnLel 



Summary 

#Include "cobjects.h" 
#lnclude "ed^nac.h" 

PLEL EdgAsInLel(pEdg) 
PEDG pEdg: 

Friend Function 

A macro is available for this ftinction 

Purpose 

The EdgAslnLel function returns a pointer to the incoming vertex ListElement 
structure contained the Edge pEdg. 

Parameter - Description 

pEdg - Pointer to a structure of type Ec2ge. 

Return Value 

The return value from the EdgAslnLel function is a pointer to the incoming 
vertex ListEHement structure contained by the Edge pEklg. 

Notes 

This function is used by the Vertex class. 

See Also 

EdgAsGrfLel. EdgAsOutLel 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgAslnLel function. 
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EdgAsOb] 



Summary 

#lnclude "cobjects.h" 
#lnclude "edgmac.h" 

POBJ EdgAsObj(pEdg) 

PEDG pEdg; 

Private Function 

Purpose 

The EdgAsObJ function returns a pointer to the Object structure contained by 
the Edge pEdg. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

The return value from the EdgAsObj function is a pointer to the Object 
structure contained by the Edge class. 

Notes 

The Object pointer can be used to send a message to the client of the edge. 

See Also 

EdgAsGrfLel, EdgAsInLel, EdgAsOutLel 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgAsObj ftinction. 
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EdgAsOutLel 



Summary 

#include "cobjects.h' 
#lnclude "edgmac.h" 



PLEL 
PEDG 



EdgAsOutLeK pEdg ) 
pEdg: 



Friend Function 

A macro is available for this function 



Purpose 



The EdgAsInLel function returns a pointer to the outgoing vertex LIstElement 
structure contained the Edge pEdg. 

Parameter - Description 



Return Value 

The retiam value from the EdgAsInLel function is a pointer to the outgoing 
vertex UstElement structure contained hy the Edge pEdg. 

Notes 

This function is used by the Vertex class. 

See Also 

EdgAsGrfLel. EdgAsInLel 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgAsOutLel function. 



pEdg 



Pointer to a structure of type £d^e. 
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EdgClear 



Summary 

#include "cobjects.h" 
#lnclude "edgmac.h" 

Void EdgOearC pEdg ) 

PEDG pEdg: 

Public Function 

Purpose 

The EkigClear function unlinks the Edge pEdg from its vertices and also 
unlinks pEklg from its graph. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

No return value 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgClear function. 
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EdgComparelnVtx 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

Bool EdgCompareInVtx( pEdg, pVtx, offset, pBlk ) 

PEDG pEdg: 
PVTX pVtx; 
Mediumint offset; 
PBLK pBlk; 

Public Function 

Purpose 

The EdgComparelnVtx function determines if the Edge pEdg has an Incoming 
Vertex pVtx. 

If the caller requires that the comparison should have additional criteria other 
than linkage, an Edge client function can be passed. The function is passed the 
matching edge to determine if this is the edge in question. 

The Block pBlk contains the client function and an optional list of argtiments. 
The function must retum a boolean (True/False) value. 

The EdgComparelnVtx function is typically used as part of a larger function for 
scanning edges. 

Parameter - Description 



pEdg - Pointer to a structure of t5rpe Edge. 

pVtx - Pointer to a structure of type Vertex where this is an 

incoming vertex. An incoming vertex has the edge as 

an outgoing edge, 

offset - The distance in bytes between an Edge and it*s client 
pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block: which contains the 
client fimction to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 



The retum value from the EdgComparelnVtx function is True if the incoming 
Vertex pVtx is linked to the Edge pEdg, otherwise False is returned. 
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EdgComparelnVtx 

Notes 

The client function should return True for the EdgComparelnVtx function to 
return True. 

The optional function will only be called if pEdg is linked to pVtx. 

See Also 

VtxFindOutEdg, VtxFlndOutEdgClient 

Diagram 

Is pVtx an incoming Vertex to pEdg ? 




Outgoing f^^X^ Incoming 

Vertex V-/ \^ Vertex 

Legend 
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EdgConnectToGrf 



Summary 

#include "cobjects.h" 
#lnclude "edgmach" 

Void EdgConnectToGrf( pEdg, pGrf ) 

PEDG pEdg; 
PGRF pGrf; 

Public Function 

A macro Is available for this function 

Purpose 

The EdgConnectToGrf function links the Edge pEdg to the Graph pGrf. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 
pGrf - Pointer to the Graph structure that the edge will be 
linked to. 

Return Value 

No return value 

Notes 

[pEdg must not already be linked to a graph.] 
IpEdg must not be linked to any vertices.] 

See Also 

EdgDisconnectFromGrf 
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EdgConnectToGrf 



Diagram 

Before 




pEdg must be linked to 

the vertices separately using 
the EdgConnectToVertices function 
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EdgConnectToVertices 



Summaiy 

#lnclude "cobjects.h" 
#lnclude "edgmac.h" 

Void EdgConnectToVertices( pEdg, pVtxI, pVtxO ) 

PEDG pEdg: 
PVTX pVtxI; 
PVTX pVtxO; 

Public Function 

Purpose 

The EdgConnectToVertices function links the Edge pEdg to the incoming Vertex 
pvtxl and the outgoing Vertex pVtxO. 

Parameter - Description 



Pointer to a structure of type Edge. 
Pointer to a structure of type Vertex where this is the 
incoming vertex. An incoming vertex has the edge as 
an outgoing edge. 

Pointer to a structure of type Vertex where this is the 
outgoing vertex. An outgoing vertex has the edge as an 
incoming edge. 

Return Vaiue 

No return value 

Notes 

[pEdg must be linked to a graph.] 
fThe Vertesc pVtxI must be linked to a graph.) 
[The Vertex pVtxO must be linked to a graph.] 
[pEdg must not be linked to any vertices.] 




pVtxO 
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EdgConnectToVertices 

See Ms 

EdgDisconnectFromVertices, EdgGetlnVtx. EdgGetOutVtx, EdgGetVertices 

Diagram 
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Vertex \^ Vertex 

Legend 



Edg-12 



EdgDelnit 



Summary 

#include "cobJects.h" 
#include "edgmac.h" 

Void EdgDelnit(pEdg) 
PEDG pEdg; 

Public Function 

Purpose 

The EdgDelnit function deinitializes the Edge object. The EdgDelnit function 
should oe the last function called when using the Edge dass. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

No return value 
Notes 

The first function to call when using the Edge class is Edglnit. 
(pEdg must not already be linked to a graph.] 
IpEdg must not be linked to any vertices.] 

See Also 

EdgDestroy, Edglnit 

Exampie 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgDelnit function. 



Edg-13 



Edg Destroy 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

Void EdgDestroy( pEdg ) 

PEDG pEdg; 

Public Function 

Purpose 

The EdgDestroy function deallocates the memory used by the object and 
delnitiaUzes the Edge object. The Edge pEdg should not be referenced after this 
function call since its memory Avill have been deallocated. 

Any vertices linked to pEdg will be unlinked and pEdg will also be unlinked 
from its graph. 

Parameter - Description 

pEdg - Pointer to a structure of type Ed^re. 

Return Value 

No return value 
Notes 

IpEdg must not have a sub-object.] 

See Also 

EdgDelnit Edglnit 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgDestroy function. 
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EdgDisconnectFromGrf 



Summary 

#include "cobjects.h" 
#include "ed^nach" 

Void EdgDisconnectFromGrf( pEde ) 

PEDG pEdg: 

Public Function 

A macro is available for this function 

Purpose 

The EdgDisconnectFromGrf function unlinks the Ed^epEdg from it's Graph. 
The function requires that any linkage to vertices be removed prior to the call. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

No return value 
Notes 

IpEdg must be linked to a graph.] 

[pEdg must not be linked to any vertices.] 

See Also 

EdgConnectToGrf. EdgDisconnectFromVertices 
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EdgDisconnectFromGrf 

Diagram 
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EdgDisconnectFrom Vertices 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

Void EdgDisconnectFrom Vertices( pEdg ) 

PEDG pEdg: 

Public Function 

Purpose 

The EdgDlsconnectFromVertices function unlinks the Edge pEdg to its 
incoming vertex and its outgoing vertex. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge, 

Return Vaiue 

No return value 
Notes 

IpEdg must be linked to a graph.] 

(pEdg must not be linked to any vertices.] 

See Aiso 

EdgConnectToVertices, EdgGetlnVtx, EdgGetOutVtx, EdgGetVertices 
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EdgDisconnectFromVertices 



Diagram 

Before After 




from Graph 
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EdgGetClient 



Summary 

#include "cobjects.h" 
#Include "edgmac.h" 

POBJ EdgGetOienKpEdg, offset) 

PEDG pEdg; 
Mediumlnt ofifset; 

Public Function 

A macro is available for this function 

Purpose 

The EdgGetClient function returns a pointer to the client of the Edge pEdg. 

Parameter - Description 



pEdg - Pointer to a structure of type Edge. 
offset - The distance in bytes between the Edge pEdg and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the EdgGetClient function is a pointer to the client of the 
Edge pEdg. 



Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgGetClient function. 
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EdgGetGrf 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 



PGRF 
PEDG 



EdgGetGrf(pEdg) 
pEdg; 



Friend Function 

A macro is available for this function 



Purpose 



The EdgGetGrf function returns a pointer to the graph that the Edge pEdg is 



Return Value 

The return value from the EdgGetGrf function is a pointer to a Graph structure 
or NULL if not linked to a graph. 

See Also 

EdglnGrf 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgGetGrf function. 



linked to. 



Parameter - Description 



pEdg 



Pointer to a structure of type Edge. 
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EdgGetlnVtx 



Summary 

#lnclude "cobjects.h" 
#include "ed^ac.h" 

PVTX EdgGetlnVtx(pEdg) 
PEDG pEdg; 

Friend Function 

A macro Is available for this function 

Purpose 

The EdgGetlnVtx function retiims a pointer to the incoming Vertex that the 
Edge pEdg is linked to. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

The return value from the EdgGetlnVtx function is a pointer to a Vertex 
structure, otherwise NULL is returned. This vertex is the incoming Vertex to 
pEdg. An incoming vertex has the edge as an outgoing edge. 

See Also 

EdgGetOutVtx, EdgGetVertices 
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I 



EdgGetNextIn 



Summary 

#Include "cobJects.h" 
#include "ed^nach" 

FEDG EdgGetNextln(pEdg) 
PEDG pEdg; 

Friend Function 

A macro Is available for this function 

Purpose 

The EdgGetNextIn function returns a pointer to the successor incoming Edge 
from the Edge pEdg or NULL If none exists. This successor edge is the next 
edge in a list of incoming edges for a vertex. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Vaiue 

The return value from the EdgGetNextIn function is a pointer to an Edge 
structure or NULL. This edge is the successor incoming edge to the Edge pEdg. 

See Also 

EdgGetNextOut 
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EdgGetNextIn 



Diagram 

Gel next incoming Edge for Vertex to pEdg 
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EdgGetNextOut 



Summary 



#indude "cobjects.h' 
#indude "ed^ach" 



PEDG 
PEDG 



EdgGetNextOut( pEdg ) 
pEdg: 



Friend Function 

A macro Is available for this function 



Purpose 



Hie EklgGetNextOut function returns a pointer to the successor outgoing Edge 
from the Edge pEdg or NULL if none exists. This successor edge is the next 
edge in a list of outgoing edges for a vertex. 



Return Value 

The return value from the EdgGetNextIn function is a pointer to an Edge 
structure or NULL. This edge is the successor outgoing edge to the Edge pE^g. 

See Also 

EdgGetNexUn 



Parameter - Description 



pEdg 



Pointer to a structure of type Edge. 
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EdgGetOutVtx 



Summary 

#include "cobjects.h' 
#include "ed^ac.h" 



PVTX 
PEDG 



EdgGetOutVtx( pEdg ) 
pEdg; 



Friend Function 

A macro is available for this function 



Purpose 



The EdgGetOutVtx function returns a pointer to the outgoing Vertex that the 
Edge pEdg is linked to. 

Parameter - Description 



Return Value 

The return value from the EdgGetOutVtx function is a pointer to a Vertex 
structure. This vertex is the outgoing Vertex to pEdg. An outgoing vertex has 
the edge as an incoming edge. 

See Also 

EdgGetlnVtx 



pEdg 



Pointer to a structure of type Edge 
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EdgGetOutVtx 

Diagram 

Gel outgoing Vertex 
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EdgGetVertices 



Summary 

#include "cobjects.h" 
#Include "edgmach" 

Void EdgGetVertices( pEdg, ppVtxI, ppVtxO ) 

PEDG pEdg: 
PVTX •ppVtxI; 
PVTX *ppVtxO: 

Public Function 

A macro is available for this function 

Purpose 

The EdgGetVertices function returns the incoming Vertex pVtxI and the 
outgoing Vertex pVtxO for the Edge pEdg. 

Parameter - Description 



pEdg - Pointer to a structure of type Edge. 

ppVtxI - Returned pointer to a structure of type pointer to 
Vertex where this is the Incoming vertex. An incoming 
vertex has the edge as an outgoing edge. 

ppVtxO - Returned pointer to a structure of type pointer to 
Vertex where this is the outgoing vertex. An outgoing 
vertex has the edge as an incoming edge. 

Return Vaiue 

No return value 

See Also 

EdgGetlnVtx, EdgGetOutVtx 
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EdgGetVertices 

Diagram 

Return both Vertices 




Outgoing i^'^w Bd^ Incoming 

Vertex W " Vertex 

Legend 



Edg-30 



EdgHasVertices 



Summaiy 

#lnclude "cobjects-h" 
#include "ed^nac.h" 

Bool EdgHasVertices( pEdg ) 

PEDG pEdg: 

Public Fxmctlon 

Purpose 

The EdgHasVertices function determines if the Edge pEdg has any vertices 
linked to it. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

The return value from the EdgHasVertices function is True if the Edge pEdg 
has any vertices, otherwise False is returned. 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgHasVertices function. 
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EdglnGrf 



Summary 



#inclu(ie "cobjects.h 
#include "edgmac.h" 



Bool 

PEDG 



EdgInGr£( pEdg ) 
pEdg; 



Public Function 

A macro is available for this function 



Purpose 

llie EdglnGrf function determines if the Ec^e pEdg is linked to a Graph. 



Return Value 

The return value from the EdglnGrf function is True if the Edge pEdg is linked 
to a Graph, otherwise False is returned. 

See Also 

EdgGetGrf 



Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdglnGrf function. 



Parameter - Description 



pEdg 



Pointer to a structure of type Edge. 



Example 
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Edglnit 

Summary 

#include "cobjects.h" 
#lnclude "ed^nach" 

Void Edglnit(pEdg) 
PEDG pEdg: 

Public Function 

Purpose 

The Edglnlt function initializes the Edge object. The Edglnit function should be 
the first function called when using the Edge class. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

Return Value 

No return value 

Notes 

The last function to call when using the Edge class is EdgDelnit. 

See Also 

EdgDelnit, EdgDestroy 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
Edglnit function. 
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EdgSend Destroy 



Summary 

#lnclude "cobjects.h" 
#lnclude "edgmac.h" 

Void EdgSendDestioy( pEdg ) 

PEDG pEdg: 

Public Function 

A macro Is available for this function 

Purpose 

The EdgSendDestroy function sends a message to the client of the Edge pEdg 
asking it to destroy the edge. The Edge client function will receive this message 
and should deinitialize or destroy the edge. This message function should be 
included in the Edge client message array. 

Parameter - Description 



pEdg - Pointer to a structure of type Edge. 

Return Value 

No return value 



Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
EdgSendDestroy function. 
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EdgUpdatelnVtx 



Summary 

#include "cobjects.h" 
#include "edgmac.h" 

Void EdgUpdateInVtx(pEdg,pVtxI) 
PEDG pEdg; 
PVTX pVtxI; 

Public Function 

Purpose 

The EdgUpdatelnVtx function replaces the current incoming vertex for the 
Edge pEdg with the Vertex pVtxI. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

pVtxI - Pointer to a structure of type Vertex where this is the 

incoming vertex. An incoming vertex has the edge as 

an outgoing edge. 

Return Value 

No return value 

Notes 

[pEdg must be linked to a graph.] 

[pEdg must be linked to two vertices.] 

[The Vertex pVtxI must be linked to a graph.] 

See Also 

EdgUpdateOutVtx 
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EdgUpdatelnVtx 



Diagram 



Update the incoming Vertex 
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EdgUpdateOutVtx 



Summary 

#Include "cobjects.h" 
#include "ed^ac.h" 

Void EdgUpdateOutVtx( pEdg, p VtxO ) 

PEDG pEdg: 
PVTX pVtxO: 

Public Function 

Purpose 

The EdgUpdateOutVtx function replaces the current outgoing vertex for the 
Edge pEdg with the Vertex pVtxO. 

Parameter - Description 

pEdg - Pointer to a structure of type Edge. 

pVtxO - Pointer to a structure of type Vertex where this is the 

outgoing vertex. An outgoing vertex has the edge as an 

incoming edge. 

Return Value 

No return value 

Notes 

[pEdg must be linked to a graph.J 

IpEdg must be linked to two vertices.] 

(The Vertex pVtxO must be linked to a graph.] 

See Also 

EdgUpdatelnVtx 
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EdgUpdateOutVtx 



Diagram 

Update the outgoing Vertex 




Legend 
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Class Reference for Graph 



Structure Name: 
Abbreviation: 
Class Type: 



Graph 
Grf 

Inheritable class 



GrfAnyCycles 



Summary 

#include "cobjects.h" 
#include "grfinac.h" 

Bool Grf AnyCydes( pGrf ) 
PGRF pGrf; 

Public Function 

A macro Is available for this function 

Purpose 

The GrfAnyCycles function determines If the graph Is acyclic. 

Parameter - Description 

pGrf - Pointer to a structure of type Grc^h. 

Return Value 

The return value from the GrfAn5rCycles function is False if the Graph pGrf is 
acyclic or True if it is not. 
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GrfAnyCycles 

Diagram 
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GrfAsEdgDll 



Summary 

#include "cobjects.h' 
#include "grfinac.h" 



PDLL 
PGRF 




Friend Function 

Purpose 

The return value from the GrfAsEdgDll function is a pointer to the List 
structure contained by the Graph pGrf. The list contains the edges of pGrf. 



Return Value 

The return value from the GrfAsEdgDll function is a pointer to the structure of 
type List contained by the Graph class. The list contains the edges of pGrf. 

See Also 

GrfAsObj. GrfAsVtxDll 



Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfAsEdgDll function. 



Parameter - Description 



pGrf 



Pointer to a structure of type Graph. 



Example 
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GrfAsObj 



Summary 



#include "cobjects.h' 
#include "grfinac.h" 



POBJ 
PGRF 



GrfAsObj( pGrf) 
pGrf: 



Private Function 



Purpose 



TTie GrfAsObj function returns a pointer to the Object structure contained by 
the Graph pGrf. 



Return Value 

The return value from the GrfAsObj function is a pointer to the Object 
structure contained by the Graph class. 



The Object pointer can be used to send a message to the client of the Graph. 
See Also 

GrfAsEdgDll, GrfAsVt?cDU 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfAsObj function. 



Parameter - Description 



pGrf 



Pointer to a structure of type Graph. 



Notes 
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GrfAsVtxDII 



Summary 

#include "cobjects.h" 
#lnclude "grfimach" 

PDLL GrfAsVtxDU(pGrf) 
PGRF pOrf; 

Ftlend Function 

Purpose 

The return value from the Gri^VtxDll function Is a pointer to the List 
structure contained by the Graph pGrf. The list contains the vertices of pGrf. 

Parameter - Description 

pGrf - Pointer to a structure of type GrapK 

Return Value 

The return value from the GrfAsEdgDU function is a pointer to the structure of 
type List contained by the Graph class. The list contains the vertices of pGrf. 

See Also 

GrfAsEdgDU, GrfAsObj 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfAsVtxDII function. 
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GrfClear 



Summary 

#include "cobjects.h" 
#include "grfinac.h" 

Void Grfaear(pGrf) 
PGRF pGrf; 

Public Function 

Purpose 

The GrfClear function unlinks all vertices and edges from the Graph pGrf. The 
topological sort arrays are also cleared. 

Parameter - Description 

pGrf - Pointer to a structure of type Graph. 
Return Vaiue 

No return value 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfClear function. 
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GrfCountEdg 



Summary 

#include "cobjects.h" 
#lnclude "grfaiac.h" 

Mediumint GrfCountEdg( pGrf ) 
PGRF pGrf; 

Public Function 

A macro is available for this function 

Purpose 

The GrfCountEdg function returns the number of edges in the Gr<y}h pGrf. 

Parameter - Description 

pGrf - Pointer to a structure of type Graph. 
Return Value 

The return value from the GrfCountEdg function is the nimiber of edges in the 
Graph pGrf. 

See Also 

GrfCountVtx 
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GrfCountEdg 

Diagram 

Number of Edges = 15 
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GrfCountVtx 



Summary 

#lnclude "cobjects.h" 
#lnclude "grfmac.h" 

Mediumint GrfCountVtx( pGif ) 
PGRF pGrf; 

Public Function 

A macro Is available for this function 

Purpose 

The GrfCountVtx function returns the number of vertices in the Graph pGrf. 

Parameter - Description 

pGrf - Pointer to a structure of type Graph. 

Return Value 

The return value from the GrfCountVtx function is the number of vertices In 
the Graph pGrf. 

See Also 

GrfCountEdg 
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GrfCountVtx 



Diagram 

Number of Vertices = 10 
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GrfDelnit 



Summary 

#include "cobjects.h" 
#include "grfinac.h" 

Void GrfDelniKpGrf) 
PGRF pGrf; 

Public Function 

Purpose 

The GrfDelnit function deinitializes the Graph object. The GrfDelnit function 
should be the last function called when using the Graph class. 

Parameter - Description 

pGrf - Pointer to a structure of type Graph, 

Return Value 

No return value 
Notes 

The first function to call when using the Graph class is Grflnit. 

The vertices and edges can be removed from the graph by calling the GrfClear 
function. 

IpGrf must not contain any vertices.] 
[pGrf must not contain any edges.] 

See Also 

GrfClear. GrfDestroy. Grflnit 

Exampie 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfDelnit function. 
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GrfDestroy 

Summary 

#lnclude "cobjects.h" 
#include "grfinac.h" 

Void GrfDestroy(pGrf ) 

PGRF pGrf; 

Public Function 

Purpose 

The GrfDestroy function deallocates the memory used by the object and 
deinitializes the Graph object. The Graph pGrf should not be referenced after 
this function call since its memory will have been deallocated. 

Any vertices or edges linked to the graph will be unlinked before destroying the 
object. 

Parameter - Description 

pGrf - Pointer to a structure of type Graph 
Return Value 

No return value 

Notes 

IpGrf must not have a sub-object.] 

See Also 

GrfDelnit, Grflnit 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfDestroy function. 
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GrfDoTopologicalSort 



Summary 

#lnclude "cobjects.h" 
#include "grfmac.h" 

Bool Gr£DoTopologicalSort(pGrf ) 

PGRF pGrf; 

Public Function 

A macro is available for this function 

Purpose 

The GrfDoTopologicalSort function sorts the vertices in the Graph pGrf in 
forward and backward topological order. 

Parameter - Description 



pGrf - Pointer to a structure of type GrapK 

Return Value 

The return value from the GrfDoTopologicalSort function is False if the Graph 
pGrf is acyclic or True if it is not. 

Notes 

Use the GrfDoTopologicalSort function prior to calling the functions 
GrfVisitVtxCllentlnTopOrderBwd or GrfVisitVtxCllentlnTopOrderFwd. There 
can be more than one ordering of the vertices which is in topological order. 

See Also 

GrfDoBasicTopologicalSort, GrfVisitVtxClientlnTopOrderBwd. 
GrfVisitVtxClientlnTopOrderFwd 
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GrfDoTopologicalSort 



Diagram 

Sort Vertices 
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GrfFindEdgClient 



Summary 

#include "cobjects.h" 
#include "grfinach" 

FOBJ GrfFindEdgOienK pGrf, offset pBlk ) 

PGRF pGrf; 
Mediumint offset; 
PBLK pBlk; 

Public Function 

Purpose 

Hie GrfFindEdgClient function walks all edges in the Graph pGrf and calls an 
Edfife client function for each edge traversed. The function terminates when the 
client function returns True or £ne last edge is readied. If a True value is 
returned, the client pointer of the edge is returned, otherwise NULL Is returned. 

The Block pBlk contains the client function and an optional list of arguments. 
The client function must return a boolean flVue/False) value. 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 

offset - The distance in bytes between an Edge and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the GrfFindEdgClient function is a pointer to the Edge 
client structure for the edge for which the client function returns True, ff no 
edge is found then NULL is returned. 

I^otes 

TTie function should return True for the GrfFindEdgClient function to return 
True. 
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GrfFindEdgClient 



See Also 

GrfFindVtxClient 

Diagram 



Walk the Edges walked in the Order 
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GrfFindVtxClient 



Summary 

#include "cobjects.h" 
#Include "grfinac.h" 

POBJ GrfFindVtxaient(pGrf, offset, pBlk) 

PGRF pGrf: 
Mediumint offset; 
PBLK pBlk; 

Public Function 

Purpose 

The GrfFindVtxClient function walks all vertices in the Graph pGrf and calls a 
Vertex client function for each verfiex traversed. The flinction terminates when 
the client function returns True or the last vertex is reached. If a True value is 
returned, the client pointer of the vertex is returned, otherwise NULL is 
returned. 

The Block pBlk contains the client function and an optional list of arguments. 
The client function must return a boolean (True/False) value. 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 

offset - The distance in bytes between a Vertex and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of ^e Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the GrfFlndVtJcCllent function is a pointer to the Vertex 
client structure for the vertex for which the client function returns True. If no 
vertex is found then NULL is returned. 

Notes 

The function should return True for the GrflFlndYtxClient function to return 
True. 
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GrfFindVtxGlient 



See Also 

GrfFlndEdgClient 

Diagram 
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GrfGetClient 



Summary 

#include "cobjects.h" 
#lnclude "grfmac.h" 

POBJ GrfGetaicnKpGrf, offset) 

PGRF pGrf; 
Mediumint offset: 

Public Function 

Purpose 

The GrfGetClient function returns a pointer to the client of the Graph pGrf . 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 
offset - Hie distance in bytes between the Graph pGrf and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the GrfGetClient function is a pointer to the client of the 
Graph pGrf. 



Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfGetClient function. 
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Grflnit 



Summary 

#include "cobjects.h" 
#include "grfinac.h" 

Void GrflniUpGrf) 
PGRF pGrf; 

Public Function 

Putpose 

The Grflnit function initializes tiie Graph pGrf. The Grflnit function should be 
the first function called when using the Graph class. 

Parameter - Description 

pGrf - Pointer to a structure of type Graph. 

Return Vaiue 

No return value 

Notes 

The last function to call when using the Graph class is GrfDelnit. 

See Also 

GrfDelnit, GrfDestroy 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
Grflnit function. 
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Grf Send Destroy 



Summary 

#include "cobjects.h' 
#lnclude "grfinach" 



Void 
PGRF 




Public Function 



Purpose 



The GrfSendDestroy function sends a message to the client of the Graph pGrf 
asking it to destroy the graph. The Graph client function will receive this 
message and should deinitialize or destroy the graph. This message function 
should be included in the Graph client message array. 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 

Return Value 

No return value 



Please refer to class test procedure TSTGRF.C for an example of the use of the 
GrfSendDestroy function. 



Example 



Grf -22 



GrfVisitEdgClient 



Summary 

#include "cobjects.h" 
#lnclude "grfinac.h" 

Void GrfVisitEdgCUentC pGrf, offset, pBlk ) 

PGRF pGrf; 
Mediumint offset; 
PBLK pBlk; 

Public Function 

Purpose 

The GrfVisitEdgClient function walks the clients of the edges of the Graph pGrf 
and calls an Ed^e client function for each edge visited. The Block pBlk contains 
the client function and an optional list of arguments. 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 

offset - The distance in bytes between an Edge and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The walk of the edges is in the order that they were added. 
The client function may return a value but it is ignored. 
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GrfVisitEdgClient 



See Also 

GrfVisltVtxClient, GrfVisltVtxClientlnTopOrderBwd. 
GrfVisltVtxClientlnTopOrderFwd 

Diagram 



Walk the Edges lalked in Uw order 
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GrfVisitVtxClient 



Summary 

#lnclude "cobjects.h" 
#lnclude "grfinac.h" 

Void GrfVisitVtxaienK pGrf , offset, pBlk ) 

PGRF pGrf; 
Mediumint offset; 
PBLK pBlk; 

Public Function 

Purpose 

The GrfVisitVtxClient function walks the clients of the vertices of the Graph 
pGrf and calls a Vertex client function for each vertex visited. The Block pBlk 
contains the client function and an optional list of arguments. 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 

offset - The distance in bytes between a Vertex and it*s client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The walk of the vertices is in the order that they were added. 
The client function may return a value but it is ignored. 
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GrfVisitVtxClient 
See Also 

GrfVisitEdgCllent, GrfVisitVtxClientlnTopOrderBwd, 
GrfVisitVtxClientlnTopOrderFwd 

Diagram 



Walk the Vertices 



Walk in the Order 




lhal Vertices vere added 



A - 1 
B - 2 



C - 3 y 

D - 4 i 

E - 5 ? 

V - R I 



H - 8 
I - 9 
J - 10 
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GrfVisitVtxClientlnTopOrderBwcl 



Summary 

#include "cobjects.h" 
#include "grfinac.h" 

Void GrfVisitVtxaientInTopOrderBwd( pGrf, offset, pBlk ) 

PGRF pGrf; 
Mediumint offset; 
PBLK pBlk; 

Public Function 

Purpose 

The GrfVisitVtxClientlnTopOrderBwd function walks all the vertices of the 
Graph pGrf and calls a Vertex client function each vertex visited. The graph is 
walked in backward topological order. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 

offset - The distance in bytes between a Vertex and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

To use the GrfVisitVtxClientlnTopOrderBwd function the graph must first be 
sorted using the GrfDoTopologicalSort function. 

The client function may return a value but it is ignored. 
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GrfVisitVtxClientlnTopOrderBwd 



See Also 

GrfVisltEdgClient, GrfVisitVtxClient. GrfVisitVtxCUent^TopOrderFwd 

Diagram 

Walk the Vertices 
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GrfVisitVtxClientlnTopOrderFwd 



Summary 

#include "cobjects.h" 
#lnclude "grfmac.h" 

Void GrfVisitVtxaientInTopOrderFwd( pGrf, offset, pBlk ) 

PGRF pGrf; 
Mediumint offset; 
PBLK pBlk; 

Public Function 

Purpose 

The GrfVisitVtxClientlnTopOrderFwd function walks all the vertices of the 
Graph pGrf and calls a Vertex client function for each vertex visited. The graph 
is walked in forward topological order. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pGrf - Pointer to a structure of type Graph. 

offset - The distance in bytes between a Vertex and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

ofiTset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

To use the GrfVisitVtxClientlnTopOrderFwd function the graph must first be 
sorted using the GrfDoTopologicalSort function. 

The client function may return a value but it is ignored. 
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GrIVisitVtxClientlnTopOrderFwd 



See Also 

GrfEdgCUent GrfVisitVtxCUent, GrfVisitVtxClientlnTopOrderBwd 

Diagram 



Walk the Vertices 
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Class Reference for JulianTime 



Structure Name: JulianTime 
Abbreviation: Jul 
Class Type: Primitive 



JulAddDays 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void JulAddDays(pJul,dy) 
PJUL pJul; 
Mediiunint dy; 

Public Function 

A macro is available for this function 

Purpose 

The JuIAddDajTS function adds to or subtracts from JuUanTime pJul a number 
of days dy. 

Parameter - Description 



pJul - Pointer to a structure of type JidianTtme. 
dy - The number of da3rs to be added. If negative then the 

number of dajrs are subtracted. 

Return Value 

No return value 

Notes 

If values greater than 89 years (dy > SHRr_MA5Q are expected the writer 
should use the JulAddDaysL fmiction. 

See Also 

JulAddDaysL, JulAddMonths, JulAddQuarters, JulAddYears 
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JulAddDays 



Example 



Jul jul; 

Char dateBuf[11]; 



r create a Julian date V 

JulDateStrToJullan( &jul, "12-23-1987". DF_US ): 

/* subtract 1 0 days from date */ 
JuiAddDays( &jul. (-10)); 

r convert the julian date to a string */ 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "This is the date %s\n", dateBuf ); 

} ' 

The following output will appear to the terminal: 
This is the date 12-13-1987 
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JulAddDaysL 



Summary 

#lnclude "cobjects.h" 
#include "julmac.h" 

Void JulAddDaysL(pJul,dy) 

PJUL pjul: 
Largeint dy; 

Public Function 

A macro is available for this function 

Purpose 

The JulAddDaysL function adds to or subtracts from JulianTime pJul a 
number of days dy. 

Parameter - Description 



pJul - Pointer to a structure of type JulianTime. 
dy - The number of days to be added. If negative then the 

nimiber of days are subtracted. 

Return Value 

No return value 

Notes 

Use this function if numbers exceeding 89 years (dy > 32,767 days) are 
encoimtered. 

See Also 

JulAddDays, JulAddMonths, JulAddQuarters, JulAddYears 
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JulAddDaysL 



Example 



Jul jul; 

Char dateBuf[11]: 



I* create a Julian date V 

JulDateStrToJulian( &jul. "12-23-1987". DF_US ): 

/* subtract 250 years from date 7 
JulAddDaysL( &jul. (-91250) ); 

r convert the julian date to a string */ 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "This is the date %s\n", dateBuf ); 

\he following output will appear to the terminal: 
This is the date 2-21 -1 738 
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JulAddMonths 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void JulAddMonthsC pjul, mnth ) 

PJUL pJul: 
Mediiunint mnth; 

Public Function 

Puipose 

The JulAddDays function adds to or subtracts from JulianTime pJul a number 
of months mnth. 

Parameter - Description 

pJul - Pointer to a structure of type JulianTime. 
mnth - The number of months to be added. If negative then 
the number of months are subtracted. 

Return Vaiue 

No return value 
Notes 

If a date overruns the end of the month the last day of the month is used. 
See Also 

JulAddDays, JulAddDaysL, JulAddQuarters, JulAddYears 
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JulAddMonths 



Example 



Jul jul; 

Char dateBuf[11]: 



r create a julian date 7 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

/* add 1 month to date */ 
JulAddMonths( &jul, 1 ); 

r convert the julian date to a string */ 
JulToDateStr( &jul, dateBuf, DF_US ); 
prlntf( "This Is the date %s\n", dateBuf ); 

Vhe following output will appear to the terminal: 
This is the date 1 -23-1 988 
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JulAddQuarters 



Summary 

#include "cobjects.h" 
#lnclude "Julmach" 

Void JtdAddQuaiters( pjul, qtis ) 

PJUL pJul: 
Mediumint qtrs; 

Public Function 

Purpose 

The JulAddQuarters function adds to or subtracts from JvlianTtme pJul a 
number of calendar quarters qtrs. 

Parameter - Description 



pJul - Pointer to a structure of type JuUanTtme, 

qtrs - The nimiber of calendar quarters to be added. If 

negative then the nimiber of calendar quarters are 

subtracted. 

Return Value 

No return value 

Notes 

Calendar quarters are measured as a year divided into 4 periods of 3 months 
each (1st period Jan-Mar, 2nd period Apr-Jun, 3rd period Jul-Sep, 4th period 
Oct-Dec). 

See Also 

JulAddDays, JulAddDaysL, JulAddMonths, JulAddYears 
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JulAddQuarters 



Example 



Jul jul; 

Char dateBuf[11]; 



r create a Julian date */ 



JulDateStrToJuljan( &jul. "12-23-1987", DF_US ): 

/* subtract 2 quarters from this date */ 
JulAddQuarters( &jul, (-2) ); 

r convert the julian date to a string */ 
JulToOateStr( &jul, dateBuf. DF.US ); 
printf( "This is the date %s\n". dateBuf ); 



The following output will appear to the terminal: 
This is the date 6-23-1 987 



Jul -9 



JulAddYears 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void JulAddYeais( pjul, yi ) 

PJUL pJul: 
Mediumint yr; 

Public Function 

Purpose 

The JulAddYears function adds to or subtracts from JidlanTtme pJul a number 
of years 3^:. 

Parameter - Description 

pJul - Pointer to a structure of type JvlianTime. 
yr - The number of years to be added. If negative then the 

number of years are subtracted. 

Return Value 

No return value 

See Also 

JulAddDays, JulAddDaysL, JulAddMonths, JulAddQuarters 
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JulAddYears 



Example 



Jul Jul; 

Char ciate6uf[11]; 



r create a julian date 7 

JulDateStrToJulian( &jul. "12-23-1987", DF_US ): 

r subtract 2 years from this date */ 
JulAddYears( &jul, (-2) ); 

/* convert the julian date to a string */ 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "This is the date %s\n", dateBuf ); 

} ' 

The following output will appear to the terminal: 
This Is the date 12-23-1985 
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JulCalendarToJulian 



Summary 

#include "cobjects.h" 
#include 'julmac.h" 



Void JulCalendarToJulian( pjul, year, month, day ) 

PJUL pJiil; 

Mediumint year; 

Mediimiint month; 

Mediumint day; 



Public Function 

Purpose 

The JulCalendarToJulian function converts the values of year, month, and day 
to the JidUmTime pJul. 

Parameter - Description 



pJul - Pointer to a structure of type JulianTime. 

year - A 4 digit year. [1583-4713] 

month - A 1-2 digit month. [1 - 12] 

day - A 1-2 digit day. [1 - 31] 



Return Value 

No return value 
Notes 

This function does no error checking and it is presimied that the csdler uses 
JuIValidateDate for error checking. 

This function is used to create a Julian time value which can be later used by 
other JulianTime routines. 

[Year must be in the range [1583:4713].] 

[Month must be in the range [1:12].] 

[Day must be a valid day for the month and year specified.] 
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JulCalendarToJulian 



See Also 

JulToCalendar 

Example 



Jul jul; 

Char dateBuf[11]; 



r create the JulianTime pointer 7 
JulCalendarToJulian( &jul, 1987, 1, 31 ); 

r create a date string */ 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "%s\n". dateBuf ); 

Vhe following output wilt appear to the terminal: 
1-31-1987 
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JulCopy 



Summary 

#lnclude "cobjects.h" 
#lndude "julmac.h" 

Void JulCopy( pJulD, pJulS ) 

PJUL pJullS; 
PJUL pJulS: 

Public Function 

A macro is available for this function 

Purpose 

The JulCopy function copies the contents of the source JidianTinie pJulS to the 
destination JulicmTime pJulD. 

Parameter - Description 

pJulD - Destination pointer to a structure of type JtdkuiTtme. 
pJulS - Source pointer to a structure of type JidianTime. 

Return Value 

No return value 
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Example 



JulCopy 



II 
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Jul julS; 
Jul julD; 
Char dateBuf[11]; 



/* create a julian date 7 

JulDateStrToJulian( &julS. "12-23-1987". DF_US ): 

/* copy the value 7 
JulCopy( &julD, &julS ); 

r lets print the copy - its the samel 7 
JulToDateStr( &julD, dateBuf, DF_US ); 
printf( "Copied date %s\n", dateBuf ); 



The following output will appear to the terminal 
Copied date 12-23-1987 



J u I Dat eSt rTo J u I ia n 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void JulDateStrToJulian(pTul,pStr,fonnat) 
PJUL pJul; 
PSTR pStr; 
DateFonnat format; 

PubUc Function 

Purpose 

The JulDateStiToJullan function creates JuUanTtme pJul from the String pStr 
which contains a date. The format of the date in the string is controlled by 
passing a date format identt&er. 

Parameter - Description 



pJul - Pointer to a structure of type JidianTime. 
pStr - Contains the string of the specified format. . 
format - Date string format. 

date format: 

DF.US > MM-DD-YYYY 
DF.EUROPE > DD-MM-YYYY 
DF_MILITARY> YYYY-MM-DD 

Return Value 

No return value 
Notes 

This function does no error checking and it is presumed that the caller uses 
JuIValidateDate for error checking. 

This routine is used to directly convert date strings to Julian time. 
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JulDateStrToJulian 



See Also 



JulTcDateStr. JuIValidateDate 



Example 



Jul jui; 
Mediumlnt year; 
Mediumint month; 
Mediumlnt day; 



I* create an JulianTime pointer from a date V 
JulDateStrToJulian( &jul, "12-23-1987", DF_US ); 

/* convert the JulianTime pointer bacl< */ 
JulToCalendar( &jul, &year. &month, &day ); 
prjntf( "date %d-%d-%d\n", month, day, year ); 



The following output will appear to the terminal: 
date 12-23-1987 
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JulDayOfWeek 



Summary 

#lnclude "cobjects.h" 
#include 'julmac.h" 

Mediumint TulDayOfWeek( pTul ) 
PJUL pJul; 

Public Function 

A macro is available for this function 

Purpose 

The JulDayOfWeek function returns the day of week ntimber for the JitlianTime 
pJul. 

Parameter - Description 



pJul - Pointer to a structure of type JuUanTime. 
Return Value 

The return value from the JulDayOfWeek function is the day of week number 
in the range 0-6. 



range: 

0 - Sunday 

1 - Monday 

2 - Tuesday 

3 - Wednesday 

4 - Thursday 

5 - Friday 

6 - Saturday 

See Also 

JulDayOfYear, JuTToDateStr 
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JulDayOfWeek 



Jul jul; 



r create a julian date */ 

JulDateStrToJulian( &jul. "12-23-1987", DF_US ): 

r get the day of the week 7 

printf( "Day of week = %d\n", JulDayOfWeek( &jul ) ); 

Vhe following output will appear to the terminal 
Day of week = 3 
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JulDayOfYear 



Summary 

#lndude "cobjects.h" 
#include "julmac.h" 

Meditunint JulDayOfYeai( pjul ) 
PJUL pJul; 

Public Function 

Purpose 

The JulDayOfYear function returns the day of the year for JulicmTtme pJul. 

Parameter - Description 

pJul - Pointer to a structure of type JidianTirne. 
Return Value 

Hie return value from the JulDa30fYear function is the day of the year in the 
range 1-365 (366 if leap year). 

See Also 

JtilDayOfWeek 
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JulDayOfYear 



Example 



^ul Jul; 



r create a julian date V 

JulDateStrToJullan( &Jul, "12-23-1987", DF_US ): 

I* get the day of the year */ 

printf( "Day of year = %d\n", JulDayOfYear( &jui ) ); 

The following output will appear to the terminal 
Day of year = 357 
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JulDayslnMonth 



Summary 

#include "cobjects.h" 
#include "jiilmac.h" 

Mediumint JulDaysInMonth( pjul ) 
PJUL pJul: 

PubUc Function 

Purpose 

The JulDayslnMonth function returns the number of days in the month of 
JulianTlme pJul. 

Parameter - Description 

pJul - Pointer to a structure of type JidianTime. 

Return Value 

The return value from the JulDayslnMonth function is the nimiber of days in 
the month represented by JidianTime pJul. 

Notes 

The return value from the JulDayslnMonth function is constant except for 
February which has 28 or 29 days dependent upon whether It is a leap year or 
not. 

See Also 

JulDaysInQuarter, JulDaysInYear 
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JulDayslnMonth 



Example 



Jul jul; 



r create a iulian date */ 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

r print the days in the above month V 

printf( "days in month = %s\n", JulDayslnMonth( &jul ) ); 

Vhe following output will appear to the terminal: 
days in month = 31 
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JulDayslnQuart^ 



Summary 

#lnclude "cobjects.h" 
#include "Julmac.h" 

Mediumint JidDaysInQuaiter( pjul ) 
PJUL pJul; 

Public Function 

Purpose 

The JulDaysInQuarter function returns the number of days in the quarter of 
JuUanTtme pJul. 

Parameter - Description 

pJul - Pointer to a structure of type JvlianTime. 

Return Value 

The return value from the JulDaysInQuarter function is the number of days in 
the quarter of JidianTime pJul. 

Notes 

Calendar quarters are measured as a year divided into 4 periods of 3 months 
each (1st period Jan-Mar, 2nd period Apr-Jun, 3rd period Jul-Sep, 4th period 
Oct-Dec). 

See Also 

JulDaysInMonth, JulDaysInYear 



Jul -24 



^ulD^yslnQuarter 



Example 



Jul jul; 



/* create a julian date 7 

JulDateStrToJulian( Ajul, "12-23-1987", DF^US ): 

/* print the days in the above quarter 7 

printf( "days in quarter = %s\n", JulDayslnQuarter( &jul ) ); 



The following output will appear to the terminal: 
days in quarter = 92 
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JulDayslnYear 



Summary 

#include "cobjects.h" 
#lnclude 'Julmac.h" 

Mediumlnt JidDaysInYearC pjul ) 
PJUL pJul; 

Public Function 

Purpose 

The JulDayslnYear function returns the number of days In the year of 
JidUmTime pJul. 

Parameter - Description 

pJul - Pointer to a structure of type JuUanTtme. 

Return Value 

The return value from the JuIDajrsInYear function is the number of days In the 
year of JuUanTime pJul. 

See Also 

JuIDaysInMonth. JulDaysInQuarter 
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JulDayslnYear 



Example 



^ul jui; 



r create a julian date V 

JulDateStrToJulian( &jul, "12-23-1987", DF^US ): 

r print the days In the above year */ 

printf( "days in year = %s\n", JulDayslnYear( &jul ) ); 

The following output will appear to the ternfiinal: 
days in year = 365 



o 
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JulDiff 



Summary 

#include "cobjects.h 
#include "Julmac.h" 



Mediumint 

PJUL 
PJUL 



JulDiff(pJull,pJul2) 

pJull; 

pJuI2; 



Public Function 

A macro is available for this function 



Purpose 

The JulDiff function returns JidUmTime pJull minus JidianTime pJul2. 



pJull - Pointer to a structure of type JidianTime. 
pJul2 - Pointer to a structure of type JuUanTime. 

Return Value 

The return value from the JulDiff function is the number of days between two 
Julian time values. 



This function is used to determine the number of days between two dates, ff 
the difference is in excess of 89 years (days <= SHKr_MAX or days > 
SHKr.MAX) the JulDifiL function should be used. 

See Also 



Parameter - Description 



Notes 



JulDiffL 
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JulDiff 



Example 

f 

^ul jull; 
Jul jul2; 



I* create two Julian date */ 

JulDateStrToJulian( &jul1, "12-30-1987". DF_US ): 

JulDateStrToJullan( &jul2, "12-23-1987". DF_US ): 

r pet the number of days between the two dates */ 

r jull - jul2 = difference */ 

printf( "Difference = %d\n". JulDiff( &jul1, &jul2 ) ); 

^he following output will appear to the terminal 
Difference » 7 
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JulDiffL 



Summary 

#include "cobjects.h" 
#lnclude "julmac.h" 

Laigeint JulDif fL( pjull, pjul2 ) 
PJUL pJull; 
PJUL pJul2: 

Public Function 

A macro is available for this function 

Purpose 

Hie JiiIDi£D^ function returns JidiariTtme pJull minus JvUanTime pJul2. 

Parameter - Description 



pJull - Pointer to a structure of type JulianTtme. 
pJul2 - Pointer to a structure of type JulianTtme. 

Return Vaiue 

The return value from the JulDiffL function is the number of days between the 
two Julian time values. 

Notes 

This function is used to determine the number of days between two dates. This 
frmction should be used if a difference in days in isxcess of 89 years (days > 
32000) is expected. 

See Also 

JulDiff 
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JulDiffL 



Example 



!lul juH; 
Jul jul2; 



r create two julian date */ 

JulDateStrToJulian( &]ul1, "12-30-1987", DF_US ): 

JulDateStrToJullan( &jul2, "12-23-1987", DF_US ): 

/* get the number of days between the two dates */ 

r iull - jul2 = difference */ 

pnntf( "Difference = %d\n". JulDiff( &jul1 , &jul2 ) ); 

The following output will appear to the terminal 
Difference = 7 
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JulGetSystemJulianDay 



Summary 

#lnclude "cobjects h" 
#include * julmac.h" 

Void JvilGetSystemJulianDaiK pjul ) 

PJUL pJial: 

Public Function 

Purpose 

The JulGetSvstemJulianDay function places the Julian time value of the 
computers clock into JidUmTirne pJul. 

Parameter - Description 

pJul - Pointer to a structure of type JulianTtrne. 

Return Value 

No return value 
Notes 

This function uses the standard C function ctimeQ and converts this returned 
string into a Julian time value. 
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JulGetSystemJulianDay 



Example 



Jul Jul; 
Mediumlnt day; 
Medium Int month; 
Mediumlnt year; 



/* get the system time V 
JulGetSystemJulianDay( &jul ); 

/* print the system date 7 

JulConvertJulian( &jul, &year, &month, &day ); 

printf( "system date %d-%d-%d\n", month, day, year ); 



The following output will appear to the terminal: 
system date [computers date] 
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Jullnit 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void Jullnit(pjul) 
PJUL pJul; 

Public Function 

A macro is available for this function 

Purpose 

The Jullnit function initializes the contents of JulianTime pJul to the beginning 
of the Gregorian calendar (rounded up a year), Januaiy 1, 1583, or Julian day 
[2299239]. 

Parameter - Description 

pJul - Pointer to a structure of type JidianTime. 

Return Value 

No return value 
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Jullnit 



Example 



Jul jul; 
Mediumint year; 
Mediumlnt month; 
Mediumint day; 
Char dateBuf[11]; 



Jullnit( &jul ); I* initialized to zero *l 



I* create a date string */ 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "%s\n", dateBuf ); 

The following output will appear to the terminal: 
1-1-1583 
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JullsLeapYear 



Summary 

#include "cobjects.h" 
#include 'julmach" 

Bool JulIsl.eapYear( yr ) 

Medlumint yr; 

Public Function 

Purpose 

The JulIsLeapYe£ir function determines if the year jn: is a leap year. 

This function is not typical of a class function in that a JuUanTtme pointer is 
not the first argument. 

Parameter - Description 

yr - A 4 digit year. 11583 - 4713] 

Return Value 

The return value from the JullsLeapYear function is True if the year yr is a leap 
year and False if jnr is not. 
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JullsLeapYear 



Example 



^ul jul; 



r see if a year is a leap year */ 
if( JullsLeapYear( 1987 ) True ) 
printf( "Is Leap Year\n" ); 

else 

printf( "Is Not Leap Year\n" ); 

} ' 

The following output will appear to the terminal: 
Is Not Leap Year 
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JullsMaxValue 



Summary 

#include "cobjects.h" 
#lnclude "Julmac.h" 

Bool JulIsMaxValue( pjul ) 

PJUL pJul; 

Public Function 

A macro is available for this function 

Purpose 

The JiiUsMaxValue function determines if JvlUmTime pJul is equal to the 
maxtmum Julian time value. 

Parameter - Description 

pJul - Pointer to a structure of type JiiJianTime. 
Return Value 

The return value from the JulIsMaxVsdue function is True if pJul is the 
maximum Julian time value, or False if not. 

Notes 

Use the JulSetMaxDate function to set the maximum Julian time value. 

See Also 

JulSetMaxDate 
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JullsMaxValue 



Example 



Jul jui; 



JulSetMaxDate( &jul ); set date to maximum V 

r check if date is maximum value V 
if( JullsMaxVaiue( &jul ) == True ) 

printf( "date is maximum\n" ); 
else 

printf( "date is NOT maxiumXn" ); 



The following output will appear to the terminal: 
date is maximum 
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JulMax 



Summary 

#include "cobjects.h" 
#lnclude "julmac.h" 



Void JulMax( pjul, pjull, pjul2 ) 

PJUL pJul; 

PJUL pJull: 

PJUL pJul2; 



Public Function 

A macro is available for this function 

Purpose 

The JulMax function places the maximum of JulianTime pJull and JidianTime 
pJul2 into JulianTime pJul. 

Parameter - Description 



pJul - Returned maximum of two Julian time values. 
pJull - Pointer to a structure of type JidianTime. 
pJul2 - Pointer to a structure of type JulianTime. 

Return Value 

No return value 

Notes 

pJuU or pJul2 can be any Julian time value. 
See Also 

JulMin 
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JulMax 



Example 



Jul 
Jul 
Jul 
Char 



ul; 

ul1; 

ul2; 

dateBuf[11]; 



r create two julian dates V 

JulDateStrToJullan( &iul1, "1 2-23-1 98r. DF_US ): 

JulDateStrToJulian( &jul2, "10-5-1987", DF_US ): 

r evalute the maximum of the two dates V 
JulMax(&jul. &jul1.&jul2); 

/* print the maximum date */ 
JulToDateStr( &jul. dateBuf, DF_US ); 
printf( "maxium date %s\n", dateBuf ); 

The following output will appear to the terminal: 
maximum date 12-23-1987 
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JulMin 



Summary 



#include "cobjects.h" 
#include "Julmac.h" 



Void 



JulMm( pjiil, pjull, pjul2 ) 



PJUL pJul; 
PJUL pJull; 
PJUL pJul2; 



Public Function 

A macro is available for this function 



Purpose 



The JulMin function places the minimum of JidianTime pJull and JidianTime 
pJul2 into JuUanTime pJul. 

Parameter - Description 



pJul2 - Pointer to a structure of type JidianTime. 

Return Value 

No return value 

See Also 

JulMax 



pJul 
pJull 



Returned minimum of two Julian time values. 
Pointer to a structure of type JvlianTime. 
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JulMin 



Example 



Jul jul; 
Jul iul1; 
Jul jul2; 

Char dateBuf[11]; 



r create two julian dates 7 

JulDateStrToJullan( &jul1. "12-23-1987", DF_US ): 

JulDateStrToJulian( &jul2, "10-5-1987", DF_US ): 

r evalute the minimum of the two dates 7 
JulMln( &jul, &jul1, &jul2 ); 

/* print the minimum date 7 
JulToDateStr( &jul, dateBuf, DF_US ); 
prlntf( "minimum date %s\n", dateBuf ); 

\he following output will appear to the terminal: 
minimum date 10-5-1987 
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JulMonthDayDiff 



Summary 

#includc "cobjects.h" 
#include "julmac.h" 

Mediumint JulMonthDayDiff( pjtil, mnth, dy ) 
PJUL pJul: 
Mediumint mnth; 
Mediumint dy; 

Public Function 

Purpose 

The JulMonthDayDiff function returns the number of days between (year of 
pJul)/mnth/dy and JidianTime pJul. 

Parameter - Description 



mnth - A 1-2 digit month. [1-12] 
dy - A 1-2 digit day. [1 - 31] 

Return Value 

The return value from the JulMonthDayDiff function is; (year of pJul)/mnth/dy 
- (minus) pJul. 



pJul 
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JulMonthDayDiff 



Example 



Jul jul; 
Mediumlnt diff; 



/* create a julian date 7 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

/* see if what the difference is V 
diff = JulMonthDayDiff( &jul. 12, 1 ); 
prlntf( "Difference = %d\n", diff ); 



The following output will appear to the terminal: 
Difference = 23 
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JulMonthString 



Summary 

#include "cobjects.h" 
#lnclude "Julmac.h" 

Void JulMonthStrmg(pJul,pStr) 
PJUL pJul; 
PSTR pStr; 

Public Function 

Purpose 

The JtilMonthString function returns the String pStr filled with the month and 
year represented by JtdianTtme pJul. The format is: 
example: Aug 1988 or Jul 2052 
8 characters 

Parameter - Description 



pJul - Pointer to a structure of type JuUanTtme. 
pStr - Returns the month string. The string should be able to 
hold 8 characters plus a NUIX terminator. 

Return Value 

No return value 

Notes 

This function is used to create string output based on Julian time values. The 
output format can be controlled to any convention by editing the Class header 
file Julmac.h and replacing the monthName ClassData string values with any 
requirement. 

See Also 

JulWeekString, JulQuarterString, JulYearString 
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JulMonthString 



Example 



Jul jul; 

Char prtBuf[4]; 



/* create a julian date */ 

JulDateStrToJullan( &Jul, "12-23-1987", DF_US ): 

r get the month string 7 
JulMonthString( &jul, prtBuf ); 
printf( "This month is %s\n", prtBuf ); 



The following output will appear to the terminal 
This month Is Dec 
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JulQuarterString 



Summary 

#include "cobjects.h' 
#include 'julmac.h" 



Void 

PJUL 

PSTR 



JulQuarterString( pjul, pStr ) 

pJul: 
pStr: 



Public Function 



Purpose 



The JulQuarterString function returns the String pStr filled with the quarter 
and year represented by JulicmT\me pJul. The format is: 
example: 1st Qtr 1987 or 4th Qtr 1988 
12 characters 



Return Value 

No return value 
Notes 

This function is used to create string output based on Julian time values. The 
output format can be controlled to any convention by editing the Class header 
file Julmac.h and replacing the quarterName ClassData string values with any 
requirement. 

Calendar quarters are measured as a year divided into 4 periods of 3 months 
each (1st period Jan-Mar, 2nd period Apr-Jun, 3rd period Jul-Sep, 4th period 
Oct-Dec). 

See Also 

JulWeekStrlng. JulMonthString, JulYearString 



Parameter - Description 



pJul 
pStr 



Pointer to a structure of type JtdianTtme. 

Returns the quarter string. The string should be able 

to hold 1 1 characters plus a NULL terminator. 
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JulQuarterString 



Example 



Jul jul; 

Char prtBuf[13]; 



/* create a jullan date */ 

JulDateStrToJulian( &iul, "12-23-1987", DF_US ): 

/* get the quarter string */ 
JulQuarterString( &jul, prtBuf ); 
printf( "This quarter is %s\n", prtBuf ); 

Vhe following output will appear to the terminal 
This quarter is 4th ar 1987 
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JulSameDayMonth 



Summary 

#lnclude "cobjects.h" 
#include "julmac.h" 

Bool JulSameDayMonth( pjull, pjul2 ) 

PJUL pJull; 
PJUL pJul2: 

Public Function 

Purpose 

The JulSameDayMonth function returns True if JidianTime pJull and 
JulianTime pJul2 have the same day and month '^ues. The year value can be 
different. 

Parameter - Description 



pJull - Pointer to a structure of type JulianTime. 
pJtil2 - Pointer to a structure of type JulianTime. 

Return Value 

The return value from the JulSameDayMonth function is True if pJull and 
pJul2 have the same day and month values. The year value can be different. 
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JulSameDayMonth 



Example 



Jul jull ; 
Jul jul2; 



I* create two julian dates 7 

JulDateStrToJullan( &jul1, "12-23-1987", DF_US ): 

JulDateStrToJullan( &jul2, "12-23-1934", DF_US ): 

I* see If the date Is the same within a year V 
lf( JulSameDayMonth( &jul1 . &jul2 ) == True ) 
printf( "Same day and month\n" ); 

else 

printf( "NOT the same day and monthXn" ); 

} ' 

The following output will appear to the terminal: 
Same day and month 
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JulSetMaxDate 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void J\ilSetMaxDate(pTul) 
PJUL pJul: 

Public Function 

Purpose 

The JulSetMaxDate function places the maximum Julian time value into 
JuMnTbme pJul. 

Parameter - Description 

pJul - Pointer to a structure of type JidianTime. 

Return Value 

No return value 
Notes 

Use the JulIsMaxValue function to compare against the maximum Julian time 
value. 

The value assigned to pJul is Julian day nimiber 2147483647. 

See Also 

JulIsMaxValue 
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JulSetMaxDate 



Example 



Jul jul; 



JulSetMaxDate( &jul ); 1* set date to maximum V 

r check if date is maximum value 7 
if( JullsMaxValue( &jul ) = True ) 

printf( "date is maximum\n" ); 
else 

printf( "date is NOT maxium\n" ); 



The following output will appear to the terminal: 
date is maximum 
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JulToCalendar 



Summary 

#include "cobjects.h" 
#include "Julmac.h" 



Void JulToCalendar( pjul, year, month, day ) 

PJUL pJul; 

Mediiimlnt *year; 

Mediumlnt *month; 

Mediumlnt *day^ 



Public Function 

Purpose 

The JulToCalendar function returns the values of year, month, and day, for the 
JtjUanTlme pJul. 

Parameter - Description 



pJul - Pointer to a structure of type JidianTtme year, 

year - Returns a 4 digit year. [1583 - 4713] 

month - Returns a 1-2 digit month. [1 - 12] 

day - Returns a 1-2 digit day. (1 - 31] 



Return Value 

No return value 
See Also 

JulCalendaiToJulian 
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JulToCalendar 



Example 



Jul jul; 
Mediumint year; 
Mediumint month; 
Mediumint day; 



r create the JulianTime pointer */ 
JulCalendarToJulian( &jul, 1987, 1, 31 ); 

/* convert the same date back 7 
JulToCalendar( &jul, &year, &month, &day ); 
printf( "date %d-%d-%d\n", month, day, year ); 



The following output will appear to the terminal: 
date 1-31-1987 
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JulToDateStr 



Summary 

#lnclude "cobjects.h" 
#include "Julmac.h" 

Void JulToDateStr( pjiil, pStr, format ) 

PJUL pJul: 
PSTR pStr; 
DateFonnat format: 

Public Function 

Purpose 

The JulToDateStr function returns the Sfrtnflf pStr filled with the date 
represented by JuUanTune pJiol. The format of the date string is controlled by- 
passing a date format identifier. 

Parameter • Description 



pJul - Pointer to a structure of type JuUanTinve. 

pStr - Returns a date string. The string should be able to 

hold 10 characters plus a NULL terminator, 
format - Date string format. 



date format: 

DF_US > MM-DD-YYYY 
DF.EUROPE > DD-MM-YYYY 
DF_MILrrARY> YYYY-MM-DD 

Return Value 

No return value 

See Also 

JulDateStiToJulian, JulValidateDate 
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JulToDateStr 



Example 



Jul jul; 

Char dateBuf[11]: 



/* create a Julian date V 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

/* convert to a date string */ 
JulToDateStr( &jul, dateBuf, DF_US ); 
printf( "This Is the date %s\n", dateBuf ); 

} ' 

The following output will appear to the terminal 
This is the date 12-23-1987 
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JulValidateDate 



Summary 

#include "cobjects.h" 
#include "Julmac.h" 

Bool JtilValidateDate( pStr, fonnat ) 

PSTR pStr: 
DateFormat format; 

Public Function 

Purpose 

The JulValidateDate function will validate a date represented by the String 
pStr. The format of the string is controlled by a date format identifier. 

This function is not typical of a class function in that a JulianTime pointer is 
not the first argument. 

Parameter - Description 



pStr - String containing the date, 
format - Date string format. 

date format: 

DF_US > MM-DD-YYYY 
DF.EUROPE > DD-MM-YYYY 
DF_MILrrARY> YYYY-MM-DD 

Return Vaiue 

The return value firom the JulValidateDate function is True if the date is valid 
and False if the date is invalid. 

Notes 

This function is used to validate date strings prior to converting them to Julian 
time. 
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JulValidateDate 



See Also 

JulCalendarToJullan, JulDateStToJulian, JulToDateStr 

Example 



Jul jul; 

Char dateBuf[11]; 



/* get string from user * 
printf( "Enter date:" ); 
gets( dateBuf ); 

/* validate a Julian date */ 
if( JulValidateDate( dateBuf ) True ) 
printf( "Good date\n" ); 

6lS6 

printf{ "Bad date\n" ); 



Example of a bad date is: 
30-2-1987 
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JulWeekString 



Summary 

#include "cobjects.h" 
#include "julmac.h" 

Void JtdWeekString(pJul,pStr) 
PJUL pJul: 
PSTR pStr: 

Public Fiuictlon 

Purpose 

The JulWeekString function returns the String pStr filled with the day and 
month represented by JutUmTiine pJul, The format is: 
example: 2 Aug or 18 Jul 

1-2 digits left justified + 3 characters 

Parameter - Description 



pJul - Pointer to a structure of type JidianTime. 
pStr - Returns the week string. The string should be able to 
hold 6 characters plus a NULL terminator. 

Return Value 

No return value 

Notes 

This function is used to create string output based on Julian time values. The 
output format can be controlled to any convention by editing the Class Header 
file julmac.h and replacing the weekMonthName ClassData string values with 
any requirement. The output format can further be controlled by editing the 
Class Source file jul.c and examining the sprintf statement within the function. 

See Also 

JulMonthStrlng, JulQuarterString, JulYearString 
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JulWeekString 



Example 



Jul Jul; 
Char prtBuf[7]; 



r create a iullan date V 

JulDateStrToJullan( &jul. "12-23-1987", DF^US ): 

r get the week string */ 
JulWeekString( &jul, prtBuf ); 
printf( "This is the %s\n", prtBuf ); 

Vhe following output will appear to the terminal 
This is the 23 Dec 
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JulYearString 



Summary 

#lnclude "cobjects.h" 
#Include "Julmac.h" 

Void JulYcarStiing(pJul,pStr) 
PJUL pJul: 
PSTR pStr; 

Public Function 

Purpose 

The JulYearString function returns the String pStr filled with the year 
represented by JulianTime pJul. The format is: 
example: 1987 or 1988 
4 characters 

Parameter - Description 



pJul - Pointer to a structure of type JulianTime. 
pStr - Returns the year string. The string should be able to 
hold 4 characters plus a NULL terminator. 

Return Vaiue 

No return value 

Notes 

This function is used to create string output based upon date values. The 
ou^ut format can be controlled to any convention by editing the Class Source 
file Jul. c and examining the sprintf statement within the function. 

See Aiso 

JulWeekString, JulMonthString, JulQuarterString 
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JulYearString 



Example 



Jul Jul; 
Char prtBuf[5]; 



r create aiulian date V 

JulDateStrToJulian( &jul, "12-23-1987", DF_US ): 

r get the year string */ 
JurYearString( &jul, prtBuf ); 
printf( "This year Is %s\n", prtBuf ); 



The following output will appear to the terminal 
This year is 1987 
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JulianTime 



This page is intentionally left blank 
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Class Reference for ListElement 



structure Name: 
Abbreviation: 
Class Type: 



ListElement 
Lei 

Inheritable class 



LeIAsObj 



Summary 

#include "cobjects.h" 
#lnclude 'lelmac.h" 

POBJ LelAsObj(pLel) 
PLEL pLel: 

Private Function 

A macro Is available for this function 

Purpose 

The LeIAsObj function returns a pointer to the Object structure contained by 
the UstElement pLel. 

Parameter - Description 

pLel - Pointer to a structure of type UstElemenL 

Return Value 

The return value from the LeIAsObj function is a pointer to the Object structure 
contained by the ListElement class. 

Notes 

The Ob/ect pointer can be used to send a message to the client of pLel. 

Example 

Please refer to class test procedure TSTLEL.C.TSTDLL.C for an example of the 
use of the LeIAsObj function. 
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LeICIientCount 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

Mediumint LelQientCountC pLel, offset pBlk ) 
PLEL pLel; 
Mediumint offset; 
PBLK pBlk; 

Public Function 

Purpose 

The LeICIientCount function returns the number of times a ListElement client 
function returns non-zero. The entire list is walked in a forward direction 
starting with the ListElement pLel. 

The Block pBlk contains the client function and an optional list of arguments. 
The function must return a Mediumint value. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement. This is the 

first list element visited, 
offset - The distance in bytes between the ListElement pLel 

and it's client pointer. The value must be 0 or negative. 
pBIk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the LeICIientCount function is the number of times the 
UstEHement client function returns non-zero. 

Notes 

(The list element can be NULL in which case the return value is zero and no 
items are processed.] 
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LeICIientCount 



Diagram 



First Element — v /—last Dement 

to Visit \ lo Visit 



First Last 



Elements to Visit 
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LeICIientDII 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

POBJ LelQientDlKpLel, offset) 

PLEL pLel; 
Mediumint offset; 

Public Function 

A macro is available for this function 

Purpose 

The LeICIientDII function retiams the client pointer of the list that the 
ListElement pLel is linked to. 

Parameter - Description 

pLel - Pointer to a structure of type ListElement. 

Return Value 

The return value from the LeICIientDII function is the client pointer of the list 
that the ListElement pLel is linked to or NULL if it is not linked to a list. 

See Also 

LelGetDU 

Example 

Please refer to class test procedure TSTLEL.C.TSTDLL.C for an example of the 
use of the LelCUentDll function. 
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LeICIientFindRange 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 



POBJ LelOientFindRangeC pUlBeg, pLelEnd, offset pBlk ) 

PLEL pLelBeg: 

PLEL pLelEnd; 

Medlumlnt offset; 

PBLK pBlk: 



Public Function 

Purpose 

The LeICIientFindRange function walks the list for the range of ListElements 
pLelBeg through pLelEnd and calls a client function for each list element 
visited. The list is walked in a forward direction. The function terminates when 
the client function returns True or the end of the list is reached. If a True value 
is returned, the client pointer of the list element is returned, otherwise NULL is 
returned. 

The Block pBlk contains the client function and an optional list of arguments. 
The function must return a boolean (True/False) value, 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See 
ListElement class section on range definition for more details. 

Parameter - Description 



pLelBeg - Pointer to a structure of type ListElement This is the 

first list element to visit. 
pLelEnd - Pointer to a structure of type ListElement This is the 

last list element to visit, 
offset - The distance in bytes between the ListElement pLel 

and it's client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the LeICIientFindRange function is the client pointer of 
the first list element for which the client function returns True. Otherwise 
NULL is returned. 
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LeICIientFindRange 



Notes 

pLelBeg and pLelEnd must belong to the same list. 

[If pLelBeg does hot equal pLelEnd then pLelBeg must precede pLelEnd.] 

Diagram 

First Element — v y — Last Element 
to Vbil pLelBeg \ /to Visit pLelEnd 




first Ust 



Walk Elements 
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LeICIientNext 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

POBJ LeiaicntNext(pUl, offset) 

PLEL pLel; 
Mediumint offset: 

Public Function 

A macro is available for this function 

Purpose 

The LeICIientNext function returns the client pointer of the succeeding list 
element to the ListElement pLel. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement. 
offset - The distance in bytes between the ListEtement pLel 
and it's client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the LeICIientNext function is the client pointer of the 
succeeding list element to the ListElement pLel or NULL if pLel is the last 
element. 

See Also 

LelGetClient LelCllentPrev 

Example 

Please refer to class test procedure TSTLEL.C,TSTDLL.C for an example of the 
use of the LeICIientNext function. 
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LelClientPrev 



Summary 

#include "cobjects.h" 
#lnclude "lelmac.h" 

POBJ LeiaientPrev(pLel, offset) 

PLEL pLel; 
Mediumint offset; 

Public Function 

A macro Is available for this function 

Purpose 

The LelClientPrev function returns the client pointer of the preceding list 
element to the UstElement pLel. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement. 
offset - The distance In bytes between the UstElemsnt pLel 
and it's client pointer. Hie value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the LelClientPrev function is the client pointer of the 
preceding list element to the UstElement pLel or NULL if pLel is the first 
element. 

See Also 

LelGetClient, LelClientNext 

Example 

Please refer to class test procedure TSTLEL.C,TSnrDLL.C for an example of the 
use of the LelClientPrev function. 
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LeICIientVisitBwd 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 



Void LeiaientVisitBwd( pLel, offset, pBlk ) 

PLEL pLel; 

Mediumint offset; 

PBLK pBlk; 



Public Function 

Purpose 

The LeICIientVisitBwd function walks the list and calls a ListElement client 
function for each list element visited. The list is walked in a backward direction 
(self to first) starting with the ListElement pLeL 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement This is the 

first list element visited. 
• offset - The distance in bytes between the ListElement pLel 

and it's client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 

(The list element may be NULL in which case no elements are visited.] 
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LeICIientVisitBwd 



See Als 

LelClientVisitFwd, LelClientVisltPredecessors, LelCllentVisitRange, 
LelClientVisitSuccessors 

Diagram 
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LeICIientVisitFwd 



Summary 

#lnclude "-objects.h" 
#lnclude "lelmac.h" 



Void LeiaientVisitFwd( pLel, oifset, pBlk ) 

PLEL pLel; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The LeICIientVisitFwd function walks the list and calls a ListElement client 
function for each list element visited. The list is walked in a forward direction 
(self to last) starting with the UstEtement pLel. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement This is the 

first list element visited, 
offset - Hie distance in bytes between the UstElement pLel 

and it's client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 

[The list element may be NULL in which case no elements are visited.] 
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LelCiientVisHFwd 



See Also 

LelClientVisitBwd, LelCllentVisitPredecessors, LelClientVisitRange, 
LelCllentVisitSuccessors 

Diagram 



First Element ^ y — Last Element 



falk Elements 
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LeICIientVisitPredecessors 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 



Void LeiaientVisitPredecessois( pLel, offset, pBlk ) 

PLEL pLel; 

Meditimint offset: 

PBLK pBlk; 



Public Ftinctlon 

Purpose 

The LeICIientVisitPredecessors function walks the list and calls a ListElernent 
client function for each list element visited. The list is walked in a backward 
direction starting with the ListElernent preceding the ListElewent pLel. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pLel - Pointer to a structure of type ListElernent. The 

predecessor to this element is the first visited. 
oflFset - The distance in b3rtes between the ListElernent pLel 

and it*s client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No retum value 

Notes 

The client function may retum a value but it is ignored. 
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LeICIientVisitPredecessors 



See Also 

LelClientVisitBwd, LelCUentVisltFwd, LelCUtntVisltRange. 
LelClientVisitSuccessors 

Diagram 



Last Element 
to Visit 
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LeICiientVisitRange 



Summary 

#lnclude "cobjects.h" 
#include "lelmac.h" 



Meditimint LelQientVisitRangeC pLelBeg, pLelEnd, offset, pBlk ) 

PLEL pLelBeg; 

PLEL pLelEnd; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The LeICiientVisitRange function walks the list for a range of ListElements 
pLelBeg through pLelEnd and calls a ListElement client fimction for each list 
element visited. 

The Block pBlk contains the client function and an optional list of arguments. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See 
ListElement class section on range definition for more details. 

Parameter - Description 



pLelBeg - Pointer to a structure of type ListElement. This is the 

first list element to visit. 
pLelEnd - Pointer to a structure of t3^e ListElement. This is the 

last list element to visit, 
offset - The distance in bytes between the ListElement pLel 

and it's client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The retum value from the LeICiientVisitRange function is the number of times 
list elements are visited. 
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LeICIientVisitRange 



Notes 

The client function may return a value but it is ignored. 

pLelBeg and pLelEnd must belong to the same list. 

[If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.] 

See Also 

LelClientVisitBwd, LelClientVisitFwd. LelClientVisitPredecessors, 
LelCIientVisitSuccessors 

Diagram 




Walk Elements 
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LeICIientVisitSuccessors 



Summary 

#include "cobjects.h" 
#include "lelmach" 



Void LeiaientVisitSuccessois( pUl, offset, pBlk ) 

PLEL pLel: 

Mediumint offset; 

PBLK pBlk: 



Public Function 

Purpose 

The LeICIientVisitSuccessors function walks the list in and calls a ListElement 
client function for each list element visited. The list is walked in a forward 
direction starting with the ListElement succeeding the ListElement pLel. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement. The 

successor to this element is the first visited, 
offset - Hie distance in bytes between the ListElement pLel 

and it's client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Vaiue 

No return value 

Notes 

The client function may return a value but it is ignored. 



Lei - 18 



LeICIientVisitSuccessors 



See Also 

LelClientVisltBwd, LelCllentVlsitFwd, LelClientVisitPredecessors, 
LelCUentVisitRange 

Diagram 



Rrsl Element v > — Last Element 

First y Ust 
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LeICountRange 



Summary 

#irclude "cobjects.h" 
#include "lelmac.h" 

Mediumlnt LelCountRange( pLelBeg, pLelEnd ) 
PLEL pLelBeg; 
PLEL pLelEnd; 

Public Function 

Purpose 

The LeICountRange function returns the number of list elements in the range 
of ListElements pLelBeg throu^ pLelEnd. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See 
ListElement class section on range definition for more detaUs. 

Parameter - Description 



pLelBeg - Pointer to a structure of type ListElement. This is the 

first list element in a range. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

last list element in a range. 

Return Value 

The return value from the LeICountRange function is the number of list 
elements in the range including the first and last ListElements pLelBeg and 
pLelEnd. 

Notes 

pLelBeg and pLelEnd must belong to the same list. 

[If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.] 
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LeICountRange 

Diagram 

first Element — \ Last Element 

in Range /r In Range 




first uist 
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LeICut 



Summary 

#include "cobjects.h" 
#lnclude "lelmac.h" 

Void LelCut(pLel) 
PLEL pLel; 

Public Function 

Purpose 

The LeICut function unlinks the ListElement pLel from the list. The list element 
preceding pLel will be linked to the successor list element of pLel. 

Parameter - Description 

pLel - Pointer to a structure of type ListElement. 

Return Value 

No return value 
Notes 

pLel must belong to a list. 

See Also 

LelCutRange, LelPasteRangeAfter, LelPasteRangeBefore 
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LeICut 



Diagram 

Before After 
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LeICutRange 



Summary 

#lnclude "cobjects.h" 
#include "lelmac.h" 



Void 
PLEL 
PLEL 
{BLK 



LelCutRange( pLelBeg, pLelEnd ) 

pLelBeg: 
pLelEnd; 



Public Function 



Purpose 



nie LeICutRange function unlinks the range of ListElements pLelBeg through 
pLelEnd from the list. The list element preceding pLelBeg will be linked to me 
successor list element of pLelEnd. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See 
UstEJemsnt class section on range definition for more details. 

Parameter - Description 



pLelBeg - Pointer to a structure of type ListElement This is the 

beginning list element to cut. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

ending list element to cut. 

Return Value 

No return value 

Notes 

pLelBeg and pLelEnd must belong to the same list. 

[If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.] 
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LeICutRange 



See Also 

LelCut, LelPasteRangeAfter, LelPasteRangeBefore 

Diagram 



Before After 
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LeIDelnit 



Summary 

#include "cobjects.h' 
#include "lelmac.h" 



Void 
PLEL 



LelDelnit(pLel) 
pLel; 



Public Function 

Purpose 

The LeIDelnit function deinitlalizes the UstElement object. The LeIDelnit 
function should be the last function called when using the ListEtement class. 



Return Value 

No return value 
Notes 

The first function to call when using the ListElement class is Lellnit. 
pLel must be cut from the list prior to calling this function. 
IHie list element must not be connected to any other elements.] 
[The list element must not be in a list.] 

See Also 

LelDestroy, Lellnit 

Example 

Please refer to class test procedure TSTrLEL.C,TSTDLL.C for an example of the 
use of the LeIDelnit function. 



Parameter - Description 



pLel 



Pointer to a structure of type ListElement. 
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LeIDestroy 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

Void LelDestroy( pLel ) 

PLEL pLel; 

Public Function 

Purpose 

The LeIDestroy function deallocates the memory used by the object and 
deinitiaUzes the ListElement object. The ListElement pLel should not be 
referenced after this function call since its memory will have been deallocated. 

The list element is cut from the list prior to before destroying the object. 

Parameter - Description 

pLel - Pointer to a structure of type Graph. 

Return Value 

No return value 

Notes 

[The instance must be the outermost subclass; it cannot have a sub-object.) 

See Also 

LelDelnlt, Lellnit 

Example 

Please refer to class test procedure TSTLEL.C,TSTDLL.C for an example of the 
use of the LeIDestroy function. 
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LeIGetClient 



Summary 

#lnclude "cobjects.h' 
#include "lelmac.h" 



POBJ 
PLEL 

Mediumint 



LelGetCUent( pUl, offset ) 

pLel; 

offset; 



Public Function 

A macro is available for this function 



Purpose 

The LeIGetClient function returns the client pointer of the ListElement pLel. 

Parameter - Description 



Return Value 

The return value from the LeIGetClient function is the client pointer of the 
ListElement pLel. 

See Also 

LelCllentNext, LelClientPrev 

Example 

Please refer to class test procedure TSTUEL.C,TSTOLL.C for an example of the 
use of the LeIGetClient function. 



pLel 



Pointer to a structure of type lAslElement. 
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LeIGetDII 



Summary 

#include "cobJects.h' 
#include "lelmac.h" 



PDLL 
PLEL 



LelGetDlKpUl) 
pLel; 



Friend Function 

A macro Is available for this function 



Purpose 



The LeIGetDII function returns a pointer to the List that the UstElementpLel is 
linked to. 

Parameter - Description 



Return Value 

The return value from the LeIGetDII function is a pointer to the List that the 
ListElement pLel is linked to. If the ListElemsnt pLel does not belong to a list 
then NUIX is returned. 



Example 

Please refer to class test procedure TSTLEL.C,TSTDLL.C for an example of the 
use of the LeIGetiDll function. 



pLel 



Pointer to a structure of type ListElement 
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LeIGetNext 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 



PLEL 
PLEL 



LelGetNext(pLel) 
pLel: 



Friend Function 

A macro is available for this function 



Purpose 



The LeIGetNext function returns a pointer to the succeeding list element to the 
UstElement pLel. 



Return Value 

The return value from the LeIGetNext function is the succeeding list element to 
the UstElement pLel. 

See Also 

LelGetNthSuccessor, LelGetPrev 



Please refer to class test procedure TSTLEL.C,TSTDLL.C for an example of the 
use of the LeIGetNext function. 



Parameter - Description 



pLel 



Pointer to a structure of type UstElement. 



Example 
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LeIGetNthSuccessor 



Summary 

#include "cobjects.h" 
#lnclude "lelmac.h" 

PLEL UlGetNthSuccessor(pUl, offset) 

PLEL pLel; 
Mediumint offset; 

Friend Function 

Purpose 

The LeIGetNthSuccessor function returns a pointer to the list element v^ch is 
the Nth successor element forward in the list from the ListElement pLel. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement. 
offset - Offset from the ListElement pLel to another list 
element. [O-ENDJ 

offset: END is the last consecutively numbered list element index. 

Return Value 

The return value from the LeIGetNthSuccessor frmction is a pointer to the Nth 
successor list element after the ListElement pLel. 

See Also 

LelGetNext, LeIGetNthSuccessor, LelGetPrev 

Example 

Please refer to class test procedure TSTLEL.C,TSTDLL.C for an example of the 
use of the LeIGetNthSuccessor function. 
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LeIGetPrev 



Summary 

#include "cobjects.h' 
#Include "lelmac.h" 



PLEL 
PLEL 



LelGetPiev( pLel ) 
pLel; 



Friend Function 

A macro is available for this function 



Putpose 



The LeIGetPrev function returns a pointer to the preceding list element to the 
ListE^ement pLel. 

Parameter - Description 



Return Value 

The return value from the LeIGetPrev function is a pointer to the list element 
preceding the UstElement pLel. 

See Also 

LelGetNext, LelGetNthSuccessor 

Example 

Please refer to class test procedure TSTLEL.C.TSTDLL.C for an example of the 
use of the LeIGetPrev function. 



pLel 



Pointer to a structure of type ListElement 
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Leilnit 



Summary 

#include "cobjects.h" 
#lnclude 'lelmac.h" 

Void LelImt(pLel) 
PLEL pLel; 

Public Function 

Purpose 

The LellnUst function determines whether the UstELement pLel is in a list. 
Parameter - Description 

pLel - Pointer to a structure of type UstElement. 

Return Value 

No return value 
Example 

Please refer to class test procedure TSTLEL.C,TSTDLL.C for an example of the 
use of the Lellnit function. 
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LeIPasteRangeAfter 



Summary 

#include "cobjects.h" 
#lnclude "lelmach" 



Void LelPasteRangeAfter( pLel, pLelBe& pLelEnd ) 

PLEL pLel: 

PLEL pLelBeg: 

PLEL pLelEnd; 



Public Function 

Purpose 

The LeIPasteRangeAfter function links a range of ListElements pLelBeg through 
pLelEnd to the List containing pLel. succeeding the ListElement pLeL 

Hie list element range must have been previous^ cut from a list. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See 
ListElement class section on range definition for more details. 

Parameter - Description 



pLel - Pointer to a structure of type ListElement. The 
elements will be linked succeeding this list element. It 
cannot be NULL. 

pLelBeg - Pointer to a structure of type ListElement. This is the 
first list element to paste into in a list. 

pLelEnd - Pointer to a structure of type ListElement. This is the 
last list element to paste into in a list. 

Return Value 

No return value 

Notes 

pLelBeg and pLelEnd must belong to the same list if any. 

[If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.l 

[pLelBeg must not already be in a list.] 
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LeIPasteRangeAfter 



Notes (cont) 

[pLel cannot be identical to either pLelBeg or pLelEnd.] 

See Also 

LelCut, LelCutRange. LelPasteRangeBefore 
Diagram 

Before After 



Paste After 
this Element 
pLel 




X)CpQj Range of Elements 

pLelBeg ^^^^^--^pLelEnd 
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LeIPasteRangeBefore 



Summary 

^include "cobjects.h" 
#include "lelmach" 



Void LelPasteRangeBef oie( pLel, pLelBeg, pLelEnd ) 

PLEL pLel; 

PLEL pLelBeg; 

PLEL pLelEnd; 



Public Function 

Purpose 

The LeIPasteRangeBefore function links a range of ListElements pLelBeg 
through pLelEnd to the List containing pLel. preceding the ListElernent pLeL 

The list element range must have been previously cut from a list. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See 
ListElernent class section on range definition for more details. 

Parameter - Description 



pLel - Pointer to a structure of lype ListElernent. The 
elements will be linked preceding this list element. It 
cannot be NULL. 

pLelBeg - Pointer to a structure of type ListElernent This is the 

first list element to link to the list. 
pLelEnd - Pointer to a structure of type ListElernent This is the 

last list element to link to me list. 

Return Value 

No return value 

Notes 

pLelBeg and pLelEnd must belong to same list if any. 

[If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.] 

[pLelBeg must not already be in a list.] 
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LeIPasteRangeBefore 



Notes (com) 

IpLel cannot be identical to either pLelBeg or pLelEnd.] — 

See Also 

LelCut LelCutRange. LelPasteRangeAfter 

Diagram 

Before After 
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LeISendDestroy 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 

Void LelSendDestroy( pLel ) 

PLEL pUl; 

Public Ftinctlon 

Purpose 

The LeISendDestroy function sends a message to the client of the ListElement 
pLel asking it to destroy pLel. The ListElement client function will receive this 
message and should destroy the list element. This message function should be 
included tn the UstESement client message array. 

Parameter - Description 

pLel - Pointer to a structure of type ListElement. 
Return Value 

No return value 

Example 

Please refer to class test procedure TSTLEL.C,TSTDLL.C for an example of the 
use of the LeISendDestroy fimction. 
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LeITest 



Summary 

#include "cobjects.h" 
#include 'lelmac.h" 

Void LelTest(pLel) 
PLEL pLel; 

Public Function 

Purpose 

The LeITest function validates the ListElement pLel. An invalid UsiElement will 
generate an exception. 

Return Value 

No return value 
Notes 

[The successor list element must point to pLel.] 
(The predecessor list element must point to pLeL] 

Example 

Please refer to class test procedure TSTLEL.C,TSTDLL.C for an example of the 
use of the LeITest function. 
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LeIVisitRange 



Summary 

#include "cobjects.h" 
#include "lelmac.h" 



Void LelVisitRange( pLelBeg, pLelEnd, pBlk ) 

PLEL pLelBeg; 

PLEL pLelEnd; 

PBLK pBlk; 



Private Function 

Purpose 

The LeIVisitRange function walks the list for the range of ListElements pLelBeg 
through pLelEnd and calls a ListElement function for each list element visited. 

The Block pBlk contains the function and an optional list of arguments. 

A range of list elements is defined as a beginning list element and an ending 
list element. The beginning element can equal the ending element. See 
ListElement class section on range definition for more details. 

Parameter - Description 



pLelBeg - Pointer to a structure of type ListElement. This is the 

beginning list element in a range. 
pLelEnd - Pointer to a structure of type ListElement. This is the 

ending list element in a range. 
pBlk - Pointer to structure of type Block which contains the 

client fimction to call and any optional parameters to 

be sent to the function. 

Return Value 

No retum value 

Notes 

Hie ListElement function may retum a value but it is ignored. 

pLelBeg and pLelEnd must belong to the same list. 

[If pLelBeg does not equal pLelEnd then pLelBeg must precede pLelEnd.] 
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LeIVisitRange 



Diagram 

First Element /— Lcsst Element 

to Visit pLelBeg \ / ^ Visit pLelEnd 




Urat KJKj!r<JKJ^< 



Walk Elements 
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ListElement 



This page is intentionally left blank 
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Class Reference for MetaClass 



Structure Name: MetaClass 

Abbreviation: Mci 

Class Type: Primitive Class 



MclCreateClass 



Summary 

#include "cobjects.h" 
#include "mcmiac.h" 

PCLS MdCreateQassC pMd ) 

PMCL pMcl; 

Private Function 

Purpose 

The MclCreateClass function creates a new class instance based on the 
MetaClass pMcl. 

Parameter - Description 

pMcl - Pointer to a structure of type MetaClass. 

Return Value 

The return value from the MclCreateClass function is a pointer to a structure 
of type Class and is the new class instance. 

Notes 

Rather than using CreateClass directly, a user should use the equivalent 
SendCreateClass function. This guarantees that if pMcl describes an extended 
Class that it is initialized properly. 

See Also 

MclDestroyClass, MclSendCreateClass, MclSendDestroyClass 

Example 

Please refer to class test procedvire TSTMCL.C for an example of the use of the 
MclCreateClass function. 
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Mcl Destroy Class 



Summary 

#include "cobiects.h" 
#include "mcfinach" 

Void MclDestroyOass( pMd, pQs ) 

PMCL pMcl; 
PCLS pCls: 

Friend Function 

Purpose 

The MclDestroyClass function deallocates the class Instance pCls previously 
allocated by the MetaClass pMcL 

Parameter - Description 



pMcl - Pointer to a structure of type MetaClass. 
pCls - Pointer to a structure of type Class. The class instance 
to be deallocated. 

Return Value 

No return value 

Notes 

pCls must have been previously allocated by MclSendCreateClass using pMcl. 

Rather than using this function directly, the equivalent function 
SendDestroyClass should be called. Tliis makes sure that if pCls is not the root 
class, that it is deinitialized properly before being deallocated. 

Class calls this function to deallocate the memory for the class after it has been 
deinitialized. 

See Also 

MclCreateClass, MclSendCreateClass, MclSendDestroyClass 
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MclDestroyClass 

Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclDestroyClass function. 
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MclFindSelector 



Summary 

#include "cobjects.h" 
#include "mcunac.h" 

Mediumlnt MclFmdSelector( pMd, pStr ) 
PMCL pMcl; 
PSTR pStr; 

Public Function 

Purpose 

The MclFindSelector function looks for the selector pStr in the MetaClass pMcl 
and returns its index which can be used to invoke the message. The function 
returns -1 if the selector is not located. 

Parameter - Description 



pMcl - Pointer to a structure of type MetaClass. The 

MetaClass being searched. 
pStr - Pointer to a StrSig. The selector name to search for. 

Return Value 

The return value from the MclFindSelector function is the index in the list of 
MetaMessages understood by pMcl. If the selector is not found, -1 is returned. 

Notes 

The comparison between pStr and the selector name is case sensitive. 



Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclP^dSelector function. 
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MclFindSuperClass 



Summary 

#include "cobjects.h" 
#include "mcunach" 

Mediumint MclFindSuperQassC pMd, pStr ) 
PMCL pMd; 
PSTR pStr; 

Public Ftinctlon 

Purpose 

The MclFindSuperClass function looks for the superclass pStr In the MetaClass 
pMcl and returns its index which can be used to locate its MetaClass. The 
nmction returns -1 if the superclass is not located. 

Parameter - Description 



pMcl - Pointer to a structure of type MetaClass. The 

MetaClass being searched. 
pStr - Pointer to a Strung. The superclass name to search for. 

Return Value 

The return value from the MclFindSuperClass function is the index in the list 
of MetaSuperClass understood by pMcl. If the superclass is not found, -1 is 
returned. 

Notes 

The comparison between pStr and the superclass name is case sensitive. 



Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclFindSuperClass function. 
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MclGetClassName 



Summary 

#include "cobjects.h" 
#include "mclinac.h" 

PSTR MdGetaassNaine( pMd ) 

PMCL pMcl; 

Public Fxmction 

Purpose 

The MclGetClassName function returns the name of the class described by the 
MetaClass pMcl. 

Parameter - Description 

pMcl - Pointer to a structure of type MetaClass. 
Return Value 

The return value from the MclGetClassName function is the name of the Class 
described by the MetaClass. 

Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclGetClassName function. 
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MclGetClassSize 



Summary 

#include "cobiects.h" 
#include "mcunac.h" 

UMediumlnt MclGetQassSizeC pMd ) 
PMCL pMcl: 

Public Function 

Purpose 

The MclGetCliassSize function returns the size of an instance of the Class 
described by the MetaClass pMcl. 

Parameter - Description 

pMcl - Pointer to a structure of type MetaClass. The 
MetaClass being searched. 

Return Value 

The return value from the MclGetClassSize function returns the size of an 
instsince of the MetaClass pMcl. 

Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclGetClassSize function. 
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MclGetMessageCount 



Summary 

#include "cobjects.h" 
#include "mcunac.h" 

Mediiimlnt MclGetMessageCotinK pMd ) 
PMCL pMd; 

Public Function 

Purpose 

The MclGetMessageCotmt function returns the total number of MetaMessages 
which are included as part of the MetaClass instance pMcl. 

Parameter - Description 

pMcl - Pointer to a structure of type MetaClass. 
Return Value 

The return value from the MclGetMessageCoimt function is the number of 
messages responded to by an instance of this type. 

Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclGetMessageCount function. 
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MclGetNthMms 



Summary 

#include "cobiects.h" 
#include "mcmiac.h" 

PMMS MclGetNthM]xis(pMcl,n) 
PMCL pMd; 
Mediumint n; 

Public Function 

Purpose 

The MclGetNthMms function returns the Nth MetaMessage described by the 
MetaClass pMcl. 

Parameter - Description 



pMcl - Pointer to a structure of type MetaClass, 
n - Ihe index of the MetaMessage to return. 

Return Value 

The return value from the MclGetNthMms function is a pointer to a structure 
of type MetaMessage which is the Nth MetaMessage described by this 
MetaClass. 

Notes 

[The message number must be greater than or equal to zero, and less than the 
number of messages.] 



Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclGetNthMms function. 
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MclGetNthOffset 



Summary 

#include "cobjects.h" 
#include "mcunac.h" 

Mediumlnt MdGetNthOffset( pMd, n ) 
PMCL pMcl: 
Mediumlnt n; 

Public Function 

Purpose 

The MclGetNthOffset function returns the offset of the Nth superclass of the 
MetaClass pMcl. The offset is used to calculate the distance between an object 
instance and its superclass. 

Parameter - Description 



pMcl - Pointer to a structure of type MetaClass. The 

MetaClass being searched, 
n - Index of the superclass whose offset is being 

calculated. 

Return Value 

The return value from the MclGetNthOffset function is the offset of the Nth 
superclass from its subclass as specified by the MetaClass pMcl. 

Notes 

For the offset to be calculated correctly, the example instance of an object of 
this MetaClass type must be the same object instance referenced by the 
MetaSuperClass described by this MetaClass. 

(The super class index must be greater than or equal to zero, and less than the 
number of superclasses.] 



Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclGetNthOffset function. 
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MclGetNthSuper 



Summary 

#include "cobiects.h" 
#include "mcunach" 

PMCL MdGetNthSuper(pMcl,n) 
PMCL pMcl; 
Mediumint n; 

Public Function 

Purpose 

The MclGetNthSuper function returns the Nth superclass MetaClass of the 
MetaClass pMcl. 

Parameter - Description 



pMd - Pointer to a structure of type MetaClass. 
n - Index of the superclass being returned. 

Return Value 

The return value from the MclGetNthSuper function is the index in the list of 
MetaMessages understood by pMcl. If the selector is not found. -1 is returned. 

Notes 

[The super class index must be greater than or equal to zero, and less than the 
number of superclasses.] 



Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclGetNthSuper function. 
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MclGetSuperClassCount 



Summary 

#lnclude "cobjects.h" 
#include "mclmac.h" 

Mediumint MclGetSuperQassCount( pMd ) 
PMCL pMcl; 

Public Function 

Purpose 

The MclGetSuperClassCount function returns the number of superclasses to 
this MetaCkLSS. 

Parameter - Description 

pMcl - Pointer to a structure of type MetaClass. 

Return Value 

The return value from the MclGetSuperClassCoimt function is the ntunber of 
superclasses in this MetaClass. 

Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclGetSuperClassCount function. 
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MclPrint 



Summary 

#include "cobjects.h" 
#include "mcunach" 



Void MclPrint( pMcl, pCio, item, level, name ) 

PMCL pMcl: 

PCIO pCio; 

Mediumint item; 

Mediumint level; 

PSTR name; 



Public Function 

Purpose 

The MclPrint function prints the contents of the MetaClass pMcl on the 
ConsolelnputOutput device pCio. The item parameter is the array index of this 
instance or -1 if it is not an array element, level is a number indicating the level 
of indentation, and name is a String pointer which is the name of this instance. 



Parameter - Description 



pMcl - Pointer to a structure of type MetaClass. 

pCio - Pointer to a structure of type ConsolelnputOutput. 

item - The array element number of this instance (or -1). 

level - the level of indentation to print this object with, 

name - the name of this instance. 



Return Value 

No return value 



Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclPrint function. 
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MclSendCreateClass 



Summaiy 

#include "cobjects.h' 
#include "mcunac.h" 



PCLS 
PMCL 



MclSendCreateaass( pMd ) 
pMcl; 



Public Function 



Purpose 



Hie MclSendCreateClass function returns an Instance of the Class described 
by the MetaClass pMcl. 

Parameter - Description 



Return Vaiue 

The return value from the MclSendCreateClass function is an instance of the 
Class described by the MetaClass pMcl. 

See Also 

MclCreateClass, MclDestroy, MclSendDestroyClass 
Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclSendCreateClass function. 



pMcl 



Pointer to a structure of type MetaClass. 
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MclSendDestroyClass 



Summary 

#include "cobjects.h' 
#include "mcunac.h* 



Void 

PMCL 

PCLS 



MdSendDestroyQassC pMd, pQs ) 

pMcl; 

pCls; 



Public Function 



Purpose 



The MclSendDestro5<;jlass function deallocates an instance of the Class pCls as 
specified by the MetaClass pMcl. 

Parameter - Description 



Return Value 

No return value 

See Also 

MclCreateClass, MclDestroyClass, MciSendCreateClass 

Example 

Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclSendDestroyClass function. 



pMcl 



Pointer to a structure of type MetaClass. 
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MclValidate 



Summary 

#include "cobjects.h' 
#include "mclmac.h" 



fl 



Void 
PMCL 



MclValidate(pMcl) 
pMcl; 



Public Function 



Purpose 

Hie MclValidate function verifies that the MetaClass pMcl is a valid instance. 



Return Value 

No return value 

Notes 

Because Instances of type MetaClass are typically statically defined and 
initialized at compile time, this function provides a way of verifying that an 
instance was initialized properly. 

Part of the validation of the instance is calling MclValidateMessages and 
McIValidateSuperClasses. 

An invalid instance will generate an exception. 

See Also 

MclValidateMessages. McIValidateSuperClasses 



Please refer to class test procedure TSTMCL.C for an example of the use of the 
MclValidate function. 



Parameter - Description 



pMcl 



Pointer to a structure of type MetaClass. 



Example 
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MetaClass 
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Class Reference for Memory 



Structure Name: Memory 

Abbreviation: Mem 

Class Type: Primitive Class 



MemClear 



Summary 

#include **cobJects.h" 
#include "memmac.h" 

Void MemQear( pMem, s, i, os ) 

Mem *pMem; 

UMediiimlnt s; 

UMediumlnt i; 

UMediumInt n; 

UMediumlnt os; 

Public Fvinctlon 

Purpose 

The MemClear function clears a section of the array pMem to zeros. The size of 
the array in elements is s, the beginning index is i, the number of elements to 
clear is n, and the size of each element is os. 

Parameter - Description 



pMem - Pointer to Memory. 

s - Size of pMem in elements, 

i - First array index to start with, 

n - Number of elements to clear. 

OS - Size of each element. 



Return Value 

No return value 

Notes 

[i must be less s.] 

[(i + n) must be less or equal to s.] 

(os must be greater than 0.] 
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MemCopy 



Summary 

#include "cobjects.h" 
#include "memmac.h" 

Void MemCopy( pMem, s, di^ os ) 

Mem *pMem; 

UMediumInt s; 

UMediumlnt di: 

UMediumInt n; 

UMediumlnt i; 

UMediumInt os; 

Public Function 

Purpose 

The MemCopy function copies a region of the array pMem to another region. 
The destination index is di, the source index is i. the size of the array in 
elements is s, the number of elements to copy is n, and the size of each 
element is os. 

Parameter - Description 

pMem - Pointer to Memory, 

s - Size of pMem in elements. 

di - Destination index. 

n - Number of elements to copy. 

i - Source index. 

OS - Size of each element. 

Return Value 

No return value 
Notes 

[i must be less s.) 
[(i + n) must be less or equal to s.] 
[os must be greater than 0.] 
[di must be less s.) 
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MemCopy 

Notes (cont) 

((di + n) must be less or equal to s.] 
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MemCutNSet 



Summary 

#lnclude "cobjects.h" 
#inclucle "memmac.h" 



Void MemCutNSet( pMem, i, n, os, c ) 

Mem ♦pMem; 

UMediumlnt s: 

UMediumlnt i; 

UMediumlnt n; 

UMediumlnt os; 

Chr c; 



Public Function 



Purpose 

The MemCutNSet function deletes a region of the array pMem and copies 
elements following the region on top of the region being cut. The size of the 
array in elements is s, the beginning of the region to cut is i, the nimiber of 
elements to cut is n, tiie size of each element is os, and c is the value to copy to 
the open positions at the end of the array. 

Parameter - Description 



pMem - Pointer to Memory. 

s - Size of pMem in elements, 

i - First array index to start with, 

n - Number of elements to cut. 

OS - Size of each element. 



Return Value 

No return value 

Notes 

[i must be less s.l 

[(i + n) must be less or equal to s.] 

[os must be greater than 0.] 
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Mem Destroy 



Summary 

#include "cobjects.h" 
#include "memmac.h" 

Void MemDestioyC pMem ) 

PMEM pMem; 

Public Function 

Purpose 

The MemDestroy function deallocates the Memory pMem previously allocated 
by MemNew. 

Parameter - Description 

pMem - Pointer to Memory. 

Return Value 

No return value 
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Mem Duplicate 



Summary 

#lticlude "cobJects.h" 
#include "memmac.h" 



Void 
Mem 

UMedlumInt 
Mem 

UMedlimiInt 



MemDuplicate( pMem, s, pMemS, os ) 
♦pMem; 

s; 

*pMemS; 
os; 



Public Fimctlon 



Purpose 

The MemDupIicate function copies the Memory pMemS to the Memory pMem. 
The size of the Memory to copy in elements is s and the size of each element is 

OS. 



Parameter - Description 



pMem - Pointer to Memory. 

s - Size of pMem in elements. 

pMemS - Pointer to Memory. 

OS ' Size of each element. 

Return Value 

No retum value 

Notes 

[os must be greater than 0.] 
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Mem New 



Summary 

#include "cobjects.h" 
#include "memmac.h" 

PMEM MemNew( amount ) 

UMediumlnt amount; 

Public Function 

Purpose 

The MemNew function returns newly allocated Memory of amount bytes. If the 
memory cannot be allocated, NULL is returned. 

Parameter - Description 

amotunt - The amoimt to allocate 

Return Value 

The return value from the function MemNew is a pointer to Memonj which was 
allocated or NULL if it could not be allocated. 
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MemPasteNSet 



Summary 

#include "cobjects.h" 
#include "menimac.h' 



Void 
Mem 



MemPasteNSet( pMem, i, n, os, c ) 
*pMem; 



UMediumlnt 
UMediumlnt 
UMediumlnt 
UMediumlnt 
Chr 



s; 

i; 
n; 
os; 
c; 



Public Function 



Purpose 



The MemPasteNSet function clears a region of the array pMem to zeros. The 
range of elements at from i through s are copied past the last element of the 
region being cleared. This results in the last n elements of the Memory pMem 
being copied over. The size of the array in elements is s, the beginning index is 
i, the nvunber of elements to clear is n, and the size of each element is os. 

Parameter - Description 



pMem - Pointer to Memory. 

s - Size of pMem in elements, 

i - First array index to start with, 

n - Number of elements to clear. 

OS - Size of each element. 

Return Value 

No return value 

Notes 

[i must be less s.] 

[(i + n) must be less or equal to s.] 

[os must be greater than 0.) 
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MemSetChr 



Summary 

#include "cobjects.h" 
#lnclude "memmac.h' 



Void 
Mem 



MemSetChr( pMem, i, os, c ) 
*pMem; 



UMediumlnt 
UMediumlnt 
UMediumlnt 
UMediumlnt 
Chr 



s: 

i; 
n; 
os; 
c; 



Public Ftinction 



Purpose 



The MemSetChr function sets a region of the array pMem to the Char c. The 
size of the array in elements is s, the beginning index is 1, the number of 
elements to clear is n» and the size of each element is os. 

Parameter - Description 



pMem - Pointer to Memory. 

s - Size of pMem in elements, 

i - First array index to start with. 

n - Number of elements to clear. 

OS - Size of each element. 

c - The character to set the region to 

Return Value 

No return value 

Notes 

li must be less s.] 

I(i + n) must be less or equal to s.J 

los must be greater than 0.] 
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Class Reference for MetaMessage 

structure Name: MetaMessage 

Abbreviation: Mms 

Class Type: Primitive Class 
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MmsGetMethod 



Summary 

#include "cobjects.h" 
#lnclude "mmsmac.h" 

PMTH MinsGetMethod( pMms ) 

PMMS pMms; 

Public Function 

Purpose 

The MmsGetMethod function returns the Method (function) pointer for the 
MetaMessage pMms or NULL if the method Is to be inherited from a 
superclass. 

Parameter - Description 



pMms - Pointer to a structure of type MetaMessage. 

Return Value 

The return value from the MmsGetMethod fimction is a (function) pointer to 
the Method associated with the MetaMesage pMms or NULL. 

Notes 

If the method returned is NULL, then this indicates the method is to be 
inherited from a superclass of the MetaClass which contains this 
MetaMessage. 

If the method is NULL and so is the superclass name, this indicates that it is 
the responsibility of a subclass to implement this function. Failure to do so is 
detected at Class creation time (MclCreateClass). 

If the method is non-NULL but the superclass is NULL, this indicates the 
message is unique to this class and not inherited from a superclass. It is up to 
the user to ensure this is true. Forthcoming versions of this code wiU verify 
this. 

If the method is non-NULL and the superclass is non-NULL, this indicates the 
message is being overridden. It is verified during Class creation 
(MclCreateClass) that the superclass name is valid and that the named 
superclass does in fact respond to the selector in this message. 
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MmsGetMethod 

See Also 

MmsGetSuper, MmsGetSelector 
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MmsGetSuper 



Summary 

#include "cobjects.h" 
#include "mmsmac.h" 

PSTR MmsGetSuper( pMms ) 

PMMS pMms; 

Public Function 

Purpose 

The MmsGetSuper function returns the String pointer which names the 
superclass the MetaMessage pMms inherits from. If this is a new message not 
inherited from any subclasses, the function returns NULL. 

Parameter - Description 



pMms - Pointer to a structure of type MetaMessage. 

Return Value 

The return value from the MmsGetSuper function is the name of the 
superclass this message is inherited from or NUIX if it is not inherited. 

Notes 

It is up to the user to initialize this value properly. Instances of this class are 
always asociated with a particular MetaClass instance. The name of the 
superclass must match precisely the name of one of the superclasses in the 
array of MetaSuperClasses contained in the MetaClass instance. 

If the method is NULL and so is the superclass name, this indicates that it is 
the responsibility of a subclass to implement this function. Failure to do so is 
detected at Class creation time (MclCreateClass). 

If the method is NULL, then this indicates the method is to be inherited from a 
superclass of the MetaClass which contains this MetaMessage. 

If the superclass name Is NULL but the method is non-NULL, this Indicates the 
message is unique to this class and not inherited from a superclass. It is up to 
the user to ensure this is true. Forthcoming versions of this code will verify 
this. 
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MmsGetSuper 



Notes (com) 

If the superclass is non-NULL and the method is non-NULL, this indicates the 
message is being overridden. It is verified during Class creation 
(MclCreateClassj that the superclass name is vSid and that the named 
superclass does in fact respond to the selector in this message. 

Typically, the name of the superclass is specified as the fijill structure name to 
which it refers. 

See Also 

MmsGetSuper. MmsGetSelector 
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MmsGetSelector 



Summary 

#lnclude "cobjects.h" 
#include "mmsmac.h" 

PSTR MmsGetSelcctoi( pMms ) 

PMMS pMms; 

Public Function 

Purpose 

The MmsGetSelector function returns a String pointer which identifies the 
MetaMessage pMms. 

Parameter - Description 

pMms - Pointer to a structure of type MetaMessage. 

Return Value 

The return value firom the MmsGetSelector function is the name of the selector 
for this message 

Notes 

It is up to the user to make sure the selector name is initialized properly. 
There must always be a selector given. 

Selectors are typically named similarly to functions, but without the structure 
name prefbc, and with the first letter lowercased. 

See Also 

MmsGetSuper, MmsGetSelector 
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MmsPrint 



Summary 

#include "cobjects.h" 
#include "mmsmac.h" 



Void MmsPrint( pMms, pCio, item, level, name ) 

PMMS pMms; 

PCIO pCio; 

Mediumint item; 

Mediumint level; 

PSTR name; 



Public Function 

Purpose 

The MmsPrint function displays the contents of the MetaMessc^e pMms on the 
ConsolelnputOutput device pCio. Item identifies if pMms is part of an array, 
level indicates the level of identing to use when printing the contents, and 
name indicates the name of this instance. 



Parameter - Description 



pMms - Pointer to a structure of type MetaMessage. 

pCio - Pointer to a structure of type ConsolelnputOutput. 

item - The array index of this instance or - 1 . 

level - The nesting level of this instance. 

name - Pointer to a String which names this instance. 



Return Value 

No return value 
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MmsValidate 



Summary 

#include "cobjects.h" 
#include "mmsmac.h" 

Void MmsValidate( pMms ) 

PMMS pMms; 

Public Punctlon 

Purpose 

The MmsValidate function determines whether or not the instance pMms is a 
valid, properly initialized MetaMessage. 

Parameter - Description 

pMms - Pointer to a structure of type MetaMessage. 

Return Value 

No return value 
Notes 

Because instances of MetaMessage are typically initialized at compile time, this 
function can be used to ensure that it was initialized properly. 

An invalid pMms will generate an exception. 
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Class Reference for MetaSuperClass 

Structure Name: MetaSuperClass 

Abbreviation: Msc 

Class Type: Primitive Class 
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MscGetName 



Summary 

#include "cobjects.h" 
#lnclude "mscmac.h" 



PSTR 
PMSC 



MscGetName( pMsc ) 
pMsc; 



Public Function 



Purpose 



The MscGetName function returns a String pointer which uniquely identifies 
the MetaSuperClass pMsc. 



Return Value 

The return value from the MscGetName function is a String pointer to the name 
of the superclass 

Notes 

There must always be a superclass name. 

Superclasses are typically named the same as the structure they refer to. 
When a class inherits from two or more superclases of the same type, the 
superclass name is prefixed with a name describing its use. 

See Also 

MscGetMetaClass 



Parameter - Description 



pMsc 



Pointer to a structure of type MetaSuperClass. 
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MscGetMetaClass 



Summary 

#include "cobjects.h* 
#include "mscmac.h' 



It 



If 



PMCL 
PMSC 



MscGetMetaaass( pMsc ) 
pMsc; 



Public Function 

Purpose 

The MscGetMetaClass function returns the pointer to a structure of type 
MetaClass for the MetaSuperClass pMsc. 



Return Value 

The return value from the MscGetMetaClass function is a pointer to a structure 
of t3^e MetaClass which is the MetaClass being inherited. 

See Also 

MscGetName 



Parameter - Description 



pMsc 



Pointer to a structure of type MetaSuperClass. 
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MscGetOffset 



Summary 

#include "cobjects.h" 
#include "mscmac.h" 

Mediumint MscGetOffset( pMsc ) 
PMSC pMsc: 

Public Function 

Purpose 

The MscGetOffset function returns the offset of a superobject from an object for 
the MetaSuperClas pMsc. 

Parameter - Description 

pMsc - Pointer to a structure of type MetaSuperClass. 

Return Value 

The return value from the MscGetOffset frmction is the offset of the superobject 
from the object. 

Notes 

The offset is used by an object to retrieve its client(s), also called subobjects. 

A side effect of this function is to calculate the offset and store it in the offset 
pointed to by this instance. 

(The superobject offset must be in the range [0:2000].] 



Msc-4 



MscPrint 



Summary 

#include "cobjects.h* 
#include "mscmac.h' 



tl 



Void 

PMSC 

PCIO 



MscPiint( pMsc, pCio, item, level, name ) 



Mediumint 
Mediumint 
PSTR 



pMsc; 
pCio; 
Item; 
level; 
name; 



Public Function 



Purpose 



The MscPrint function displays the contents of the MetaSuperClass pMsc on 
the ConsolelnputOutput device pCio. Item identifies if pMsc is part of an 
array, level indicates the level of identing to use when printing the contents, 
and name indicates the name of this instance. 

Parameter - Description 



pMsc - Pointer to a structure of type MetaSuperClass. 

pCio - Pointer to a structure of type ConsolelnputOutput. 

item - The array index of this instance or -1. 

level - The nesting level of this instance. 

name - Pointer to a String which names this instance. 

Return Vaiue 

No return value 
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MscValidate 



Summary 

#include "cobjects.h' 
#include "mscmac.h' 



tl 



Void 
PMSC 



MscValidate( pMsc ) 
pMsc; 



Public Function 

Purpose 

The MscValidate function verifies that the MetaSuperClass pMsc Is a valid 



Return Value 

No return value 

Notes 

Because instances of type MetaSuperClass are typically statically defined and 
initialized at compile time, this fimction provides a way of verifying that an 
instance was initialized properly. 

This function is called by MclValidate, 

An invalid instance will generate an exception. 

See Also 

MclValidate, MmsValidate 



Instance. 



Parameter - Description 



pMsc 



Pointer to a structure of type MetaSuperClass. 



Msg -6 



Class Reference for Message 



Structure Name: Message 

Abbreviation: Msg 

Class Type: Primitive Class 



MsgDelnit 



Summary 

#include "cobjects.h" 
#include "msgmac.h" 

Void MsgDeIiiit( pMsg ) 

PMSG pMsg: 

Public Function 

Purpose 

The MsgDelnit function deinitializes the Message pMsg. The MsgDelnit 
function should be the last function called when using the Message pMsg. 

Parameter - Description 

pMsg - Pointer to a structure of type Messc^e. 

Return Value 

No return value 

See Also 

MsgDestroy, Msglnit 
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MsgGetOffset 



Summary 

#lnclude "cobjects.h" 
#include "msgmac.h" 

Mediumint MsgGetOffset( pMsg ) 
PMSG pMsg; 

Public Function 

Purpose 

The MsgGetOffset function returns the Object offset for the Message pMsg. 

Parameter - Description 

pMsg - Pointer to a structure of type Message. 

Return Value 

The return value from the MsgGetOffset function is the Object offset for this 
message. 
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MsgGetMethod 



Summary 

#include "cobjects.h" 
#include "msgmach" 

PMTH MsgGetMethbd(pMsg) 
PMSG pMsg; 

Public Function 

Purpose 

The MsgGetMethod function returns a pointer to a Method which implements 
the Message pMsg. 

Parameter - Description 

pMsg - Pointer to a structure of type Message. 

Return Value 

The return value from the MsgGetMethod function is a pointer to a Method 
which implements pMsg. 
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MsgGetSelector 



Summary 

#lnclude "cobjects.h" 
#lnclude "msgmac.h" 

PSTR MsgGetSelector( pMsg ) 

PMSG pMsg: 

Public Function 

Purpose 

The MsgGetSelector function returns a pointer to a String containg the selector 
name. 

Parameter - Description 

pMsg - Pointer to a structure of type Message. 
Return Value 

The return value from the MsgGetSelector ftmction is a pointer to a String 
containing the selector name. 
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Msglnit 



Summary 

#include "cobjects.h" 
#include "msgmac.h" 

Void Msglnit( pMsg> pCls, pMms ) 

PMSG pMsg: 
PCLS pCls: 
PMMS pMms; 

Public Function 

Purpose 

The Msglnit function initializes the Message pMsg of the Class pCls with the 
MetaMessage pMms. 

Parameter - Description 



pMsg - Pointer to a structure of type Message. 
pels - Pointer to a structure of type Class. 
pMms - Pointer to a structure of type MetaMessage. 

Return Value 

No return value 
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MsgPrint 



Summary 

#include "cobjects.h* 
#lnclude "msgmac.h' 



Void 

PMSG 

PCIO 



pMsg: 
pCio; 
item; 
level; 
name; 



MsgPrint( pMsg^ pCio, item, level, name ) 



Mediumint 
Mediimilnt 
PSTR 



Public Function 

Purpose 

The MsgPrint function prints the contents of the Message pMsg on the 
ConsolelnputOutput device pCio. The item parameter is the array index of this 
instance or -1 if it is not an array element, level is a ntimber indicating the level 
of indentation, and name is a String pointer which is the name of this instance. 

Parameter - Description 



pMsg - Pointer to a structure of type Message. 

pCio - Pointer to a structure of type ConsolelnputOutput. 

item - The array element number of this instance (or - 1). 

level - the level of indentation to print this object with, 

name - the name of this instance. 

Return Vaiue 

No retum value 
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MsgSend 



Summary 

#include "cobjects.h" 
#include "msgmac.h" 

Void MsgSend(pMsg,pObj,pBlk) 
PMSG pMsg; 
POBJ pObJ; 
PBLK pBlk; 

Public Function 

Purpose 

The MsgSend function sends the Message pMsg to the Object pObj and passes 
the Block pBlk parameters to the fianction which implements the message. 

Parameter - Description 



pMsg - Pointer to a structure of type Message. 

pObj - Pointer to a structure of type Object. 

pBlk - Pointer to a structure of type Block. 

Return Value 

No return value 
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MsgSendReturnlnt 



Summary 

#lnclude "cobjects.h' 
#include "msgmac.h' 



PMSG 
POBJ 
PBLK 



Meditunint 



pObj; 
pBlk; 



MsgSendRetumInK pMsg, pObj, pBlk ) 

pMsg; 



Public Function 



Purpose 



The MsgSendReturnlnt function sends the Message pMsg to the Object pObj 
and passes the Block pBlk parameters to the function which implements the 
message. The return value is the value returned by the function implementing 
the message. 

Parameter - Description 



pMsg - Pointer to a structure of type Message. 
pObj - Pointer to a structure of type Object 
pBlk - Pointer to a structure of type Block. 

Return Value 

The return value from the MsgSendReturnlnt function is a the value returned 
by the method. 
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MsgSendReturnPtr 



Summary 

#include "cobjects.h" 
#include "msgmac.h" 

Void MsgSendRetuniFtr(pMsg,pObj,pBIk) 
PMSG pMsg: 
POBJ pObj: 
PBLK pBlk; 

Public Function 

Purpose 

The MsgSendReturnPtr function sends the Message pMsg to the Object pObj 
and passes the Block pBlk parameters to the function which implements the 
message. The return value is the value returned by the function implementing 
the message. 

Parameter - Description 



pMsg - Pointer to a structure of type Message. 

pObj - Pointer to a structure of type Object 

pBlk - Pointer to a structure of type Block. 

Return Vaiue 

No return value 
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Class Reference for Object 



Structure Name: 
Abbreviation: 
Class Type: 



Object 
Obj 

Primitive Class. 



ObJDelnit 



Summary 



#include "cobjects.h' 
#include "objmac.h" 



Void ObjD( 
POBJ pObj; 




j) 



Public Function 



Purpose 

The ObjDelnit function deinltializes the Object pObj. 

Parameter - Description 



pObj 

Return Value 



Pointer to a structure of type Object 



No return value 



Notes 



If the object was created from d3niamlc memory via ClsCreateObJect, then the 
function ObjDestroy should be called instead of ObJDelnit. 

If the object was created from statically allocated memory, it should have been 
initialized via ObJInit in which case ObjDelnit should be used to deinitialize it. 

The ObjDelnit function should be the last reference to pObj. 

See Also 

ClsCreateObJect, ObjDestroy, Objinit 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjDelnit function. 
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ObjDestroy 



Summary 



#include "cobjects.h' 
#include "objmac.h" 



Void ObiD. 
POBJ pObj: 




) 



Public Function 

Purpose 

The ObjDestroy function deinltializes and deallocates the Object pObj. The 
Object pObJ should not be referenced after this call since the memory will have 
been freed. 

Parameter - Description 

pObj - Pointer to a structure of type Object 

Return Value 

No return value 

Notes 

If the object was created from dynamic memory via ClsCreateObject, then the 
function ObjDestroy should be called instead of ObjDelnit. 

If the object ^s created from statically allocated memory, it should have been 
initialized via Objinit in which case ObjDelnit should be used to deinitiaUze it. 

See Aiso 

ClsCreateObject. ObjDestroy, Objinit 



Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjDestroy frmction. 



Example 
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ObjGetClient 



Summary 

#lnclude "cobjects.h" 
#include "objmac.h" 

POBJ ObjGetaienK pObj, offset ) 

POBJ pObj: 
Mediumlnt offset; 

Public Function 

Purpose 

The ObjGetClient function returns the client Object of the Object pObJ located 
at offset. 

Parameter - Description 



pObj - Pointer to a structure of type Object 
offset - The distance in bytes between the Object pObj and it's 
client pointer. 

Return Value 

The return value from the ObjGetClient function Is a pointer to an Object. 
Notes 

The offset is calculated when the Class which defines pObj was created. See 
the section on Classes and MetaClasses for more details. 

The range for offset Is [-2000:2000]. ff the offset is zero or negative it means the 
object being retrelved is a subobject (or client) of pObj. If the offset is positive, 
the object being retrieved is a superobject of pObj. 

See Also 

ObjGetCUentOrNull 



Obj-4 



ObjGetClient 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetClient function. 
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ObJGetClientOrNull 



Summary 

#include "cobjects.h" 
#include "objmac.h" 

POBJ ObjGetaientOrNulK pObj, offset ) 

POBJ pObj; 
Mediumint offset; 

Public Function 

Purpose 

The ObjGetClientOrNull function returns the client Od/ect of the Object pOhj 
located at offset. If pObJ is NULL, NULL is returned. 

Parameter - Description 



pObj - Pointer to a structure of type Object. 
offset - The distance in b}rtes between tihe Object pObj and it's 
client pointer. 

Return Value 

The return value from the ObjGetClientOrNull function is a pointer to an 
Object 

Notes 

The offset is calculated when the Class which defines pObj was created. See 
the section on Classes and MetaClasses for more details. 

The range for offset is [-2000:2000]. If the offset is zero or negative it means the 
object being retreived is a subobject (or client) of pObj. If the offset is positive, 
the object being retrieved is a superobject of pObj. 

See Also 

ObjGetClient 
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ObjGetClientOrNull 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetClientOrNull function. 
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ObJGetCIs 



Summary 

#include "cobjects.h" 
#include "objmac.h" 

PCLS ObjGeias( pObj ) 

POBJ pObj; 

Public Function 

Purpose 

The ObjGetCls function returns a pointer to a structure of type Class which is 
the Class of the Object pObJ. 

Parameter - Description 

pObJ - Pointer to a structure of type Object 

Return Value 

The return value from the ObjGetCls function is a pointer to a structure of type 
Class which is the Class of pObj. 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetCls function. 
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ObjGetClsName 



Summary 

#include "cobjects.h' 
#include "objmac.h" 



PSTR 
POBJ 



ObiGetasName( pObj ) 
pObj: 



Public Fimction 



Purpose 



The ObjGetClassName function returns a pointer to a String which cont£dns the 
name of the Class which defines the Object pObJ. 

Parameter - Description 



Return Value 

The return value from the ObjGetClassName function is a pointer to a String 
containing the cl£iss name 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetClsName function. 



pObJ 



Pointer to a structure of type Object. 
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ObjGetlmmediateClient 



Summary 

#lnclude "cobjects.h" 
#include "objmac.h" 

POBJ ObjGetlmmediateaienti pObi ) 

POBJ pObj; 

Public Function 

Purpose 

The ObjGetlmmediateClient function retiims the immediate client Object of the 
Object pObJ. The immediate client is the object which directly subclasses pObJ. 

Parameter - Description 

pObJ - Pointer to a structure of type Object 

Return Value 

The return value from the ObjGetlmmediateClient fimction is a pointer to an 
Object 

See Also 

ObjGetClient 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGretlmjnediateClient function. 



Obj-lO 



ObJGetMethodAndOffset 



Summary 

#include "cobjects.h" 
#lnclude "objmac.h" 



Void ObiGetMethodAndOffset( pObj, m, ppMth, pOffset ) 

POBJ pObj: 

Medlumint m; 

PMTH •ppMth; 

Mediumlnt *pOffset; 



Public Function 

Purpose 

Hie ObjGetMethodAadOffset function returns a pointer to the Method which 
implements the message identified by the message selector index m for the 
Object pObi. It also returns the offset which will determine the object to be 
passed to the method. The Method pointer is returned in ppMth and the offset 
in pOffset 



Parameter - Description 



pObj - Pointer to a structure of type Object. 

m - The message selector index. 

ppMth - Pointer to a pointer to Method. 

pOffset - Pointer to a Mediimilnt. 



range: *pOffset will be in the range [-2000:2000). A negative value means a 
client of^ pObJ is overriding the message. A positive value means pObJ is 
inheriting the method from a superobject. A zero value is ambiguous and could 
be a client overriding the method or the method may be implemented by pObj. 

Return Value 

No return value 
Notes 

m must be in the range I0:N-1] where N is the number of objects pObj can 
respond to. 

[The message number must be greater than or equal to zero, and less than the 
number of messages.] 
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ObjGetMethodAndOffset 

Example 

Please refer to class test procedure TSTOBJ:C for an example of the use of the 
ObjGetMethodAndOffset function. 
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ObjGetNthSuperObject 



Summary 

#includv3 "cobjects.h" 
#lnclude "objmac.h" 

POBJ ObjGetNlhSuperObject(pObj,n) 
POBJ pObj: 
Mediiomlnt n; 

Public Function 

Purpose 

The ObjGetNthSuperObject function returns the Nth superobject of the Object 
pObj. 

Parameter - Description 

pObj - Pointer to a structure of type Object 
n - The index of the superobject. 

Return Value 

The return value from the ObjGetNthSuperClient function is a pointer to an 
Object. 

Notes 

[The super class index must be greater than or equal to zero, and less than the 
number of superclasses.] 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetNthSuperObject function. 
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ObjGetRootClient 



Summary 

#include "cobjectf .h" 
#include "objmac.h" 

POBJ ObjGetRootOientC pObj ) 

POBJ pObj: 

Public Function 

Purpose 

The ObjGetRootClient function returns the Root client object of the Object 
pObj. 

Parameter - Description 

pObJ - Pointer to a structure of type Object 

Return Value 

The return value from the ObjGetRootClient function is a pointer to an Object. 

Notes 

The root client is the client Object which has no subobjects. 

See Also 

ObjGetlmmediateClient, ObjGetClient 
Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetRootClient function. 
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ObJGetRootClientSize 



Summary 



#include "cobjects.h' 
#include "objmac.h" 



POBJ pObj: 



Mediumint Obi 




Public Function 

Purpose 

The ObJGetRootClientSize function returns the size of the root Object of the 
Object pObj. 



Return Value 

The return value from the ObJGetRootClientSize function is the size of the root 
Ob/ect of pObj. 

See Also 

ObjGetSize 



Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObJGetRootClientSize function. 



Parameter - Description 



pObJ 



Pointer to a structure of type Object 



Example 
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ObjGetSize 



Summary 

#include "cobjects.h" 
#lnclude "objmac.h" 

Medimnint ObjGetSize( pObj ) 
POBJ pObJ: 

Public Function 

Purpose 

The ObjGetSlze function returns the size of the Object pObj. 

Parameter - Description 

pObj - Pointer to a structure of type Object 

Return Value 

The return value from the ObjGetSize function is the size of pObj. 

See Also 

ObJGetRootObjectSize 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjGetSize function. 
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ObJGetSubObjectOffset 



Summary 

#include "cobjects.h" 
#Include "objmac.h" 



Mediumlnt ObiGetSubObjectOffseK pObi 
POBJ pObj: 



Public Function 

Purpose 

The ObJGetImmediateClientO£fset function returns the offset of the immediate 
client. 

Parameter - Description 

pObj - Pointer to a structure of type Object 
Return Vaiue 

The return value from the ObjGetlmmediateClientOfiFset function is the offset of 
the immediate client object. 

See Also 

ObJOethnmediateClient. ObjOetClient, ObJGetRootClient 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObJGetSubObjectOffset function. 
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Objinit 



Summary 

#include "cobjects.h" 
#lnclude "objmac.h" 

Void ObjInit( pObj, pQs ) 

POBJ pObj; 
PCLS pCls; 

Public Function 

Purpose 

The Objinit function Initializes the Object pObj to be an object of Class pCls. 

Parameter - Description 

pObj - Pointer to a structure of type Object 
pCls - Pointer to a structure of type Class. 

Return Value 

No return value 

Notes 

If pObj was created with ClsCreateObject it does not need to be initialized since 
Objinit is called automatically. 

If pObj was statically allocated, Objinit should be the first function called. 

See Also 

ClsCreateObject, ObjDelnit, ObjDestroy 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
Objinit function. 
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ObjIsRoot 



Summary 

#include "cobjects.h' 
#lnclude "objmach" 



Bool 
POBJ 



ObjlsRoot(pObj) 
pObj; 



Public Fiuictlon 



Purpose 



The ObjIsRoot fianction returns True If the Object pObj is a root Object, that is, 
it does not have a subobject. 

Parameter - Description 



Return Value 

The return value from the ObjIsRoot function True if pObj is a root object or 
False otherwise. 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjIsRoot function. 



pObj 



Pointer to a structure of type Object 
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ObjRespondsToSelector 



Summary 

#include "cobjects.h' 
#include "objmac.h" 



Mediumlnt 

POBJ 

PSTR 



ObjR 
pObj 
pStr; 




pObj, pStr ) 



Public Function 



Purpose 



The ObjRespondsToSelector function returns the index of the message selector 
if the Object pObJ can respond to the selector String pointer pStr. If the Object 
pObj does not respond to the message, -1 is returned. 



Return Value 

The return value from the ObjRespondsToSelector function is True if pObj 
responds to the selector and False otherwise. 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjRespondsToSelector function. 



Parameter - Description 



pObj 
pStr 



Pointer to a structure of type Object 

Pointer to String which contains the selector name 
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ObjSendMessage 



Summary 

#lnclude "cobjects.h" 
#lnclude "objmach" 

Void ObjSendMessage( pObL m, pBlk ) 

POBJ pObJ: 
Mediumint m; 
PBLK . pBlk; 

Public Function 

Purpose 

The ObjSendMessage function sends the message identified by its selector 
index m to the Otiject pObj. The Block pBlk can be used to pass parameters to 
the method implementing the message. 

Parameter - Description 



pObJ - Pointer to a structure of type Object. 

m - The message selector Index. 

pBlk - Pointer to a structure of type Block. 

Return Value 

No return value 
Notes 

(The message number must be greater than or equal to zero, and less than the 
nimiber of messages.) 

See Also 

ObjSendMessageRetumInt, ObjSendMessageRetumPtr 
Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjSendMessage function. 
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ObjSendMessageReturnInt 



Summary 

#include "cobjects.h" 
#include "objmac.h" 

Mediumint ObjSendM essageRetumlntC pObj, m, pBlk ) 

POBJ pObj; 
Mediumint m; 
PBLK pBlk: 

Public Function 

Purpose 

The ObjSendMessageReturnInt function sends the message identified by its 
selector index m to the Object pObj. The Block pBlk can be used to pass 
parsmieters to the method implementing the message. The return value is the 
value returned by the method. 

Parameter - Description 



pObj - Pointer to a structure of type Object. 

m - The message selector index. 

pBlk - Pointer to a structure of type Block. 

Return Value 

TTie return value from the ObjSendMessageReturnInt function is the value 
returned by the method which implements the message. 

Notes 

(The message number must be greater than or equal to zero, and less than the 
ntmiber of messages.] 

See Also 

ObjSendMessage, ObjSendMessageRetumPtr 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjSendMessageReturnInt function. 
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ObjSendMessageReturnPtr 



Summary 

#include "cobjects.h" 
#include "objmac.h" 



Void ObjSendMessageRetumFtr( pObj, m, pBlk ) 

POBJ pObj; 

Mediumint m; 

PBLK pBlk; 



Public Function 

Purpose 

The ObjSendMessageReturnPtr function sends the message identified by its 
selector index m to the Object pObj. The Block pBlk can be used to pass 
parameters to the method implementing the message. The return value is the 
value returned by the method. 



Parameter - Description 



pObj - Pointer to a structure of type Object 

m - The message selector index. 

pBlk - Pointer to a structure of type Block. 



Return Value 

No return value 
Notes 

(The message number must be greater than or equal to zero, and less than the 
number of messages.] 

See Also 

ObjSendMessage, ObjSendMessageRetumInt 

Example 

Please refer to class test procedure TSTOBJ.C for an example of the use of the 
ObjSendMessageReturnPtr function. 
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Object 
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Class Reference for String 



Structure Name: String 
Abbreviation: Str 
Class Type: Primitive. 



StrExtract 



Summary 

#include "cobjects.h" 
#include "stnnac.h" 



PSTR StrExtract(pStiD,pStrS/idx,n) 

PSTR pStrD: 

PSTTR pStrS: 

Mediumlnt idx; 

Mediumint n; 



Public Function 

Purpose 

The StrExtract function extracts the sub-string pStrD from the String pStrS 
starting at an index idx and for a number of characters n. 

Parameter - Description 



pStrD - Returns the extracted sub-string. 

pStrS - String to be extracted from. 

idx - Starting index for string extraction. [0 - length] 

n - Number of characters to be extracted. 



Return Value 

The return value from the StrExtract function is a pointer to the string 
extracted, or NULL. 

See Also 

StrReplaceSubStr 
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StrExtract 



Example 



{ 

char buffer[32]; 



r extract a sub-string from a string */ 
r starting at index 4 for 5 characters */ 
StrExtract( buffer, "ABCD12345EFGHIJK", 4. 5 ); 

printf( "buffer = %s\n", buffer ); 

Vhe following output will appear to the terminal: 
buffers 12345 
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Str From Date 



Summary 

#lnclude "cobjects.h" 
#include "strmac.h" 



Void StrFromDate( pStr, f onnat, yeax, month, day ) 

PSTR pStr; 

DateFormat format; 

Mediumint year; 

Mediumint month; 

Mediumint day; 



Public Function 

Purpose 

The StrFromDate function returns the String pStr filled with the date 
represented by the values year, month, and day. The format of the date string 
is controlled by passing a date format identifier. 



Parameter - Description 



pStr - Returns the date string. The string should be able to 

hold 10 characters plus a NULL terminator, 
format - Date string format, 
year - A 4 digit year. [1583-4712] 
month - A 1-2 digit month. 11-12] 
day - A 1-2 digit day. (1 - 31] 



date format: 

DF_US > MM-DD-YYYY 
DF_EUROPE > DD-MM-YYYY 
DF_MILrrARY> YYYY-MM-DD 

Return Value 

No return value 
Notes 

This function is used to create date strings and is used by the JulianTirne class. 
The format can be controlled to any convention by editing the Class Source 
Code file str.c and examining the prlntf statement within the function. 
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StrFromDate 



See Also 

StiToDate, JuUulianToDateStr 

Example 

char dateBuf[11]; 

r create a string from the values of year, month, and day 7 
StrFromDate( dateBuf, DF_US, 1988, 12, 23 ); 

printf( "date %s\n". dateBuf ); 
} ' 

The following output will appear to the terminal: 
date 12-23-1988 
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StrFromMediumInt 



Summary 

#inv-lude "cobjects.h" 
#include "stnnac.h" 

Mediumint StrFromMediuinInt( pSbv maxLen, num ) 
PSTR pStr; 
Mediumint maxLen; 
Mediumint num; 

Public Function 

Purpose 

The StrFromMediumInt function returns the String pStr for the value num. 

Parameter - Description 

pStr - Returned string. The string should be able to hold the 
characters represented by tiie number plus a NULL 
terminator. 

maxLen - Maximimi length of string. 

num - Value to be converted to a string. 

Return Vaiue 

The return value from the StrFromMediumInt function is the length of the 
string returned. The length of pStr is alwa3rs less than or equal to maxLen. 

See Also 

StiToMediumInt 
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StrFromMediumInt 



Example 

char buff eitS]; 

/* create a string from an integer */ 
StrFromMediumlnt( buffer, 2, 23 ); 

printf( "buffer %s\n-, buffer ); 

Vhe following output will appear to the terminal: 
buffer 23 
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Strlnit 



Summary 

#include "cobjects.h" 
#include "strmac.h" 

Void Stilnit(pStr) 
PSTR pStr; 

Public Function 

A macro is available for this function 

Purpose 

The Strlnit function sets the String pStr contents to NULL. 

Parameter - Description 

pStr - A pointer to String. 

Return Value 

No return value 

Example 

Please refer to class test procedure TSTTSTFLC for an example of the use of the 
Strlnit function. 
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StrReplaceSubStr 



Summary 

#include "cobjects.h" 
#include "strmac.h" 

Void StrReplaceSubStrC pStrOrg, pStrFrom, pStrTo, maxLen ) 

PSTR pStrOrg; 'r o'r 

PSTR pStrFrom; 
PSTR pStiTo; 
Mediumbit maxLen; 

Public Function 

Purpose 

The StrReplaceSubStr function replaces the sub-string pStrProm of the String 
pStrOrg with the sub-string pStiTo. 

Parameter - Description 



pStrOrg - Returns the string with sub-string replaced. 

pStrFrom - Sub-string of original. 

pStiTo - Sub-string to be used for replacement. 

maxLen - Maximum length of string. 

Return Value 

No return value 

Notes 

[maxLen must be in the range [0: 128].] 

See Also 

StrExtract 
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StrReplaceSubStr 



Example 

char buffeitIO]; 
/* create a string */ 

strcpy( buffer. "ABCD12345EFGHIJK" ); 

r replace a sub-string in a string V 
StrReplaceSubStr( buffer. "12345". "XX". 16 ); 

printf( "buffer %s\n". buffer ); 

Vhe following output will appear to the tenninal: 
buffer ABCDXXEFGHIJK 
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StrSet 



Summary 

#lnclude "cobjects.h" 
#include "strmac.h" 

Void StrSet( pStrD, pStrS ) 

PSTR pStrD: 
PSTR pStrS: 

Public Function 

A macro is available for this function 

Purpose 

The StrSet function copies the String pStrS to the the String pStrD. 

Parameter - Description 

pStrD - Returns the string with sub-string replaced. 
pStrS - Sub-string of original. 

Return Value 

No return value 
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StrSet 



Example 

charstr[20]; 

r copy string to another string */ 
StrSet( str. "ABCD" ); 

printf{ "str = %s\n", str); 

Vhe following output will appear to the terminal: 
str = ABCD 
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StrSqueeze 



Summary 

#lnclude "cobjects.h" 
#lnclude "strmac.h" 

Void StrSqueeze(pStTD,pStrS,ch) 
PSTR pStrD; 
PSTR pStrS; 
Char ch; 

Public Function 

Purpose 

The StrSqueeze function removes all occurences of the character ch from the 
Strtng pStr. 

Parameter - Description 



pStrD - Returns the string with specified character removed, 

pStrS - String for character removal, 

ch - Single character to be removed. 

Return Value 

No return value 



Str- 13 



StrSqueeze 



Example 

charbuffer[10]; 

r create a string V 

strcpy( buffer, "ABCD12345" ); 

/* remove a sub-string from a string 7 
StrSqueeze( buffer, buffer, "123" ); 

printf( "buffer %s\n", buffer ); 

Vhe following output will appear to the terminal: 
buffer ABCD45 
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StrToDate 



Summary 

#include "cobjects.h" 
#include "strmac.h" 



Void StiToDate( pSti, format, year, month, day ) 

PSTR pStr; 

DateFormat format; 

Mediumint *year; 

Mediiunint *month; 

Mediumint *day; 



Public Function 

Purpose 

The StiToDate function converts the String pStr, containing a date, into the 
values of year, month, day. The format of the date string is controlled by 
passing a date format identifier. 



Parameter - Description 



pStr - Contains the date string of specified format. 

format - Date string format. 

year - Returns a 4 digit year. {1583 - 4712J 

month - Returns a 1-2 digit month. (1 - 12] 

day - Returns a 1-2 digit day. [1-31] 



date format: 

DF_US > MM-DD-YYYY 
DF_EUROPE > DD-MM-YYYY 
DF_MILITARY> YYYY-MM-DD 

Return Value 

No return value 
Notes 

This function is used to parse date strings and is used by the JulianTime class. 
The format can be controlled to any convention by editing the Class Source 
Code file Jul.c and examining the sscanf statement within the function. 
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StrToDate 

Notes (com) 

[The length of pStr must be less than 12.) 

See Also 

StrFromDate, JulDateStiToJulian, JtdValldateDate 

Example 

{ 

Int year; 
Int month; 
int day; 

r create year, month, and day from a string */ 
StrToDate( "12-23-1988", DF_US, &year, &month, &day ); 

printf( "date %d/%d/%d\n", month, day, year ); 

The following output will appear to the terminal: 
date 12/23/1988 
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StrToLower 



Summary 

#include "cobjects.h" 
#lnclude "strmac.h" 

Void StrToLower( pStr ) 

PSTR pStr; 

Public Function 

A macro Is available for this function 

Purpose 

The StiToLower function changes the case of the String pStr to all lower case. 

Parameter - Description 

pStr - Strtr^ to be changed to lower case. 
Return Value 
No return value 
Notes 

The StrToI^wer fiinctlon uses the C library function tolowerQ. 



Str- 17 



StrToLower 



Example 

char buffer[10]; 

r create a string 7 

strcpy( buffer, "ABCDEFGHIJK" ); 

I* convert the entire string to lower case 7 
StrToLower( buffer ); 

printf( "buffer = %s\n", buffer ); 

Vhe following output will appear to the terminal: 
buffer s abcdefghljk 
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StrToMediumInt 



Summary 

#include "cobjects.h" 
#include "strmac.h" 

Mediumlnt StrToMediumInK pStr ) 
PSTR pStr; 

Public Function 

Purpose 

The StiToMediumInt function returns the numerical representation of the 
String pStr. 

Parameter - Description 

pStr - String to be converted to a integer value. 

Return Value 

The return value from the StiToMediumInt function is the numerical 
representation of the String pStr. 

Notes 

The StiToMediimiInt uses the C library function atoiQ. 
See Also 

StrFromMediumInt 
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StrToMediumInt 

Example 

{ 

int i; 

/* create an integer from the string */ 
i » StrToMeciiumlnt( "23" ); 

printf( "value = %d\n", 1 ); 

Vhe following output will appear to the terminal: 
value = 23 
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StrToUpper 



Summary 

#lnclude "cobjects.h" 
#include "strmac.h" 

Void StrToUpper(pStr) 
PSTR pStr; 

Public Function 

A macro Is available for this function 

Purpose 

The StrToUpper function changes the case of the String pStr to all upper case. 

Parameter - Description 

pStr - String to be changed to upper case. 

Return Value 

No return value 

Notes 

The StrToUpper function uses the C library function toupperQ. 
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StrToUpper 



Example 

char buffer[10]; 

r create a string */ 

strcpy( buffer, "abcdefghijk" ); 

/* convert the entire string to upper case V 
StrToUpper( buffer ); 

printf( "buffer » %s\n", buffer ); 

Vhe following output will appear to the terminal: 
buffer = ABCDEFGHIJK 
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Class Reference for Tree 



structure Name: 
Abbreviation: 
Class Type: 



Tree 
Tre 

Inheritable class 



TreAsDII 



Summary 

#lnclude "cobjects.h' 
#lnclude "tremac.h" 



POLL 
PTRE 



TreAsDlK pTre ) 
pTre; 



Private Function 

A macro is available for this function 



Purpose 



The return value from the TreAsDU fimctlon is a pointer to the List structure 
contained by the Tree pTre. The list contains the children of pTre. 

Parameter - Description 



Return Value 

The return value from the TreAsDll frmction is a pointer to the structure of type 
List contained by the Tree class. The list contains the child nodes of pTre. 

See Also 

TreAsLel, TreAsObj 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreAsDll function. 



pTre 



Pointer to a structure of type Tree. 
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TreAsLel 



Summary 

#lnclude "cobjects.h" 
#lnclude "tremach" 

FLEL TreAsLel(pTre) 
FIKE pTVe; 

Private Ftinction 

A macro Is available for this function 

Purpose 

The TreAsLel function returns a pointer to the ListElement structure contained 
by the Tree pTre. The ListElement references the successor and predecessor 
sibling of pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 

Return Vaiue 

The return value from the TireAsLel function is a pointer to the ListElement 
structure contained by the Tree pTre. The list element references the successor 
and predecessor sibling of pTre. 

See Also 

TreAsDll, TreAsObj 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreAsLel function. 
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TreAsObj 



Summary 

#include "cobjects.h' 
#include "tremac.h" 



POBJ 

PTRE 



TreAsObj( pTre ) 
pTre: 



Private Function 

A macro Is available for this function 



Purpose 



The TreAsObj function returns a pointer to the Object structure contained by 
the Tree pTre. 

Parameter - Description 



Return Value 

The return value from the TreAsObj function Is a pointer to the Object 
structure contained by the Tree class. 



The Object pointer can be used to send a message to the client of the Tree. 
See Also 

TreAsDll, TreAsLel 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TteAsObj function. 



pTre 



Pointer to a structure of type Tree. 



Notes 
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TreClear 



Summary 

#include "cobjects.h' 
#include "tremac.h" 



Void 
PTRE 



Treaear( pTre ) 
pTre; 



Public Function 



Purpose 



The TreClear function unlinks and destroys any children of the Tree pTre. If 
pTre is a child node then pTre is cut from the tree. 

Parameter - Description 



Return Value 

No return value 
Notes 

[pTre must have no child nodes.] 
IpTre must be the root node.] 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreClear function. 



pTte 



Pointer to a structure of type Tree. 
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TreClient 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreaienK pTre, offset ) 

PTRE pTre; 
Medliimint offset: 

Public Function 

A macro Is available for this function 

Purpose 

The TreClient function returns a pointer to the client of the Tree pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bj^es between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClient function is a pointer to the client of the 
Tree pTre. 

See Aiso 

TreClientFirstChild, TreClientLastChild, TreClientLastLeaf, TreClientNext, 
TreClientNextPreOrder. TreCllentNextUncle, TreClientParent. TreClientPrev, 
TreClientPrevPreOrder 

Exampie 

Please refer to class test procedure TSTTE^.C for an example of the use of the 
TreClient function. 
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TreClientFindChild 



Summary 

#include "cobjects.h" 
#include "tremac.h" 



POBJ TreaientFindChild( pTre, offset, pBlk ) 

FTRE pTre; 

Mediumint offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientFindChild function walks a Tree and calls the Tree client function 
for each tree node visited. The Tree is walked in a forward direction starting 
with the first child of pTre and ending with the last child of pTre, The function 
will terminate when the client function returns True or the last child is 
reached. If the client function returns True a pointer to the client of the tree 
node is returned otherwise NULL is returned. 

The Block pBlk contains the client function and an optional list of arguments. 
The client function must return a boolean (True/False) value. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bjrtes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of tj^e Block which contains the 
client function to call and any optional parameters to 
be sent to the fimction. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientFindChild function is a pointer to the client 
of the first child of the Tree pTre for which the client function returns True. 
Otherwise NULL is retumed. 
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TreClientFindChild 



Diagram 



Find a Child by Visiting Children 




O EJement Not Visited 
First 



Element Visited and Order 

Last 
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TreClientFirstChild 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreaientFirstChild( pTre, offset ) 

PTRE pTre; 
Mediumlnt offset: 

Public Function 

A macro is available for this function 

Purpose 

The TreClientFirstChild function returns the client of the first child of the Tree 
pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientFirstChild function is a pointer to the client 
of the first child of the Tree pTre. NULL is returned if there are no children. 

See Also 

TreClient, TreClientLastChild, TreClientLastLeaf. TreClientNext, 
TreClientNextPreOrder, TreClientNextUncle, TreClientParent. TreClientPrev. 
TVeClientPrevPreOrder 



Tre-9 



TreClientFirstChild 



Diagram 



First Child of pTre 
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TreClientLastChild 



Summary 

#lnclude "cobjects.h" 
#lnclude "tremac.h" 

P06J TreaientLastChild( pTre, offset ) 

PTRE pTre; 
Mediumint offset; 

Public Ftinction 

A macro is available for this function 

Purpose 

The TreClientLastChild function returns the client of the last child of the Tree 
pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientLastChild function is a pointer to the client 
of the last child of the Tree pTre. NULL is returned if there are no children. 

See Also 

TreCllent, TreClientLastChild, TreCllentLastLeaf. TreClientNext, 
TreClientNextPreOrder, TreClientNextUncle, TreClientParent, TreClientPrev, 
TreClientPrevPreOrder 
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TreClientLastChild 



Diagram 



Last Child of pTre 
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TreClientLastLeaf 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreOientLastLeaf ( pTre, offset ) 

PTRE pTre: 
Mediumlnt offset; 

Public Function 

A macro is available for this function 

Purpose 

The TreClientLastLeaf function returns the client of the last leaf of the Tree 
pTre, The last leaf is found by calling TreClientLastLeaf recursively for the last 
child of pTre until a tree node is visited that has no children. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - TTie distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientLastLeaf function is a pointer to the client 
of the last leaf of the Tree pTre. NULL is returned if there are no children. 

See Aiso 

TreClient, TreClientFirstChild, TreClientLastChild, TreClientNext, 
TreClientNextPreOrder, TreClientNextUncle, TreClientParent. TreClientPrev, 
TreCllentPrevPreOrder 
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TreClientLastLeaf 

Diagram 

Last Leaf of pTre 
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TreClientNext 



Summary 

#include "cobjects.h" 
#lnclude "tremac.h" 

POBJ TreQientNcxK pTre, offset ) 

PTRE pTre; 
Mediumint offset; 

Public Function 

A macro is available for this function 

Purpose 

The TreClientNext function returns the client of the successor sibling of the 
Tree pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientNext function is a pointer to the client of 
the next sibling of the Tree pTre. NULL is returned if there is no sibling. 

See Also 

TreClient, TreClientFirstChild, TreCllentLastChild. TreClientLastLeaf, 
TreClientNextPreOrder, TreCllentNextUncle. TreClientParent, TreClientPrev, 
TVeClientPrevPreOrder 
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TreClientNextPreOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreaientNextPreOrder(pTre, offset) 

PTRE pTre; 
Mediumint offset; 

Public Function 

A macro is available for this function 

Purpose 

The TreClientNextPreOrder fianction returns the client of the pre-order 
successor to the Tree pTre. The pre-order successor is: i) the first child of pTre; 
ii) the successor sibling of pTre: iii) the uncle of pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientNextPreOrder function is a pointer to the 
client of the PreOrder successor of the Tree pTre. NULL is returned if no 
PreOrder successor exists. 

See Aiso 

TreCUent, TreClientFirstChild, TreCUentLastChild, TreClientLastLeaf, 
TreCUentNext. TreClientNextUncle, TVeClientParent, TVeCUentPrev, 
TreClientPrevPreOrder 
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TreClientNextPreOrder 



Diagram 

Next node of pTre in Pre- order 
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TreClientNextUncle 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POB J TreaientNextUncle( pTre, offset ) 

PTRE pTre; 
Mediumlnt offset; 

Public Function 

A macro Is available for this function 

Purpose 

The TreClientNextUncle function returns the client of the successor uncle of 
the Tree pTre. The next uncle Is found by taking the successor of the parent of 
pTre. If the parent has no successor the function TreClientNextUncle is called 
recursively until the root node is reached or an uncle is found. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. Hie value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientNextUncle function is a pointer to the client 
of liie next uncle of the Tree pTre. NULL is returned if there is no uncle node. 

See Also 

TreClient, TreClientFirstChild, TreClientLastChild, TreClientLastLeaf, 
TreClientNext. TreClientNextPreOrder, TreClientParent, TreClientPrev, 
TreClientPrevPreOrder 
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TreClientNextUncle 



Diagram 



Successor Uncle of pTre 



pTre 
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TreClientParent 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreaientPaientC pTrc, offset ) 

PTRE pTre: 
Mediumint offset; 

Public Function 

A macro is available for this function 

Purpose 

The TteClientParent function returns the client of the parent of the Tree pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance In b3rtes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Vaiue 

The return value from the TreClientParent function is a pointer to the client of 
the parent of the Tree pTre. NULL is returned if no node exists. 

See Also 

TreClient TreClientFirstChild, TreClientLastChild, TYeClientLastLeaf, 
TreClientNext, TreClientNextPreOrder, TreClientNextUncle, TreClientPrev, 
TreClientPrevPreOrder 
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TreClientParent 



Diagram 



Parent of pTre 
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TreCllentPrev 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

POBJ TreaientPrev( pTre, offset ) 

PmE pTre: 
Mediumlnt offset; 

Public Function 

A macro is available for this function 

Purpose 

The TreClientPrev function returns the client of the preceding sibling of the 
Tree pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientPrev function is a pointer to the client of the 
previous sibling of the Tree pTre. NULL is returned if no previous sibling exists. 

See Also 

TreClient. TreClientFirstChlld. TreClientLastChild, TreClientLastLeaf, 
TreCUentNext. TreClientNextPreOrder, TreClientNextUncle. TreClientParent, 
TreClientPrevPreOrder 
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TreClientPrev 



Diagram 



Preceding Sibling of pTre 
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TreClientPrevPreOrder 



Summary 

#lnclude "cobjects.h" 
#include "tremach" 

POBJ TreaientPievPreOrder( pTrc, offset ) 

PTRE pTre: 
Mediumint offset; 

Public Fumctlon 

A macro Is available for this function 

Purpose 

The TreClientPrevPreOrder function returns the client of the pre-order 
predecessor the Tree pTre. The pre-order predecessor is the previous sibling of 
pTre. If pTre has no previous sibling the function TreClientPrevPreOrder is 
called recursively for the parent of pTre. 

Parameter - Description 



pTVe - Pointer to a structure of type Tree. 
offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

offset: See the Cbzss Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the TreClientPrevPreOrder function is a pointer to the 
client of the pre-order predecessor of the Tree pTre. NULL is returned if pTre 
has no parent. 

See Also 

TreClient, TreClientFirstChlld. TVeClientLastChlld, TreCUentLastLeaf. 
TreClientNext, TreClientNejctPreOrder, TreCllentNextUncle, TreClientParent, 
TreCUentPrev 



Tre-25 



TreCllentPrevPreOrder 



Diagram 

Previous node of pTre in Pre- order 
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TreClientVisitBranchlnOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 



Void TreClientVisitBranchInOrder( pTre, offset pBlk ) 

PTRE pTre; 

Mediumint offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitBranchlnOrder function walks a Tree and calls the Tree 
client function for each tree node visited. The tree is walked by calling 
TreClientVisitBranchlnOrder recursively for each of its children, and then 
visiting pTre itself. The nodes are visited if they are branches (have children). 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTVe - Pointer to a structure of type Tree, The root of a tree 
walk. 

pffset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to tlie function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it Is ignored. 
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TreClientVisitBranchlnOrder 



See Also 

TreCllentVisitSuccPreOrder, TreClientVisitPreOrder, TreClientVisitChildren, 
TreCllentVisitChildrenBwd, TreClientVisitlnOrder, TreCUentVisitlnOrderBwd, 
TreClientVisitDescBranchlnOrder, TreClientVisitDescPreOrder, 
TreClientVisitDescInOrder, TreClientVisitDescInOrderBwd, 
TreClientVisitLeaves, TreClientVisitParents, TVeCUentVisitRange, 
TreCUentVisitSuccessors 



Diagram 



Walk the branches In-order 
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TreCIIentVisitChildren 



Summary 

#include- "cobjects.h" 
#include "tremac.h" 



Void TreaientVisitChildren( pTre, offset, pBlk ) 

PTRE pTre; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitChildren function walks a Tree and calls the Tree client 
fiinction for each tree node visited. The Tree is walked for each of the children 
of the Tree pTre starting with its first child and ending with its last child. 

The Block pBlk contains the client fiinction and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

oflFset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Vaiue 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitChildren 



See Also 

Ti sClientVisitSuccPreOrder, TreCllentVisitBranchlnOrder, 
TreClientVisitPreOrder. TVeCllentVisitChlldrenBwd, TreClientVisitlnOrder, 
TreClientVisitlnOrderBwd, TreClientVisitDescBranchlnOrder, 
TreClientVisitDescPreOrder. TreCllentVisitDescInOrder, 
TreClientVisitDescInOrderBwd, TreClientVisitLeaves, TreClientVisitParents, 
TreClientVisltRange. TreClientVisitSuccessors 

Diagram 



Walk the Tree for all Children 
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TreClientVisitChildrenBwd 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 



Void TreaientVisitChildrenBwd( pTrc, offset pBlk ) 

PTRE pTre; 

Mediiimint ofTset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitChildrenBwd function walks a Tree and calls the Tree client 
function for each tree node visited. The Tree is walked for each of the children 
of the Tree pTte starting with its last child and ending with its first child. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. Th& root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The client function may return a value but it is ignored. 
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TreClientVisitChildrenBwd 



See Also 

TreClientVisitSuccPreOrder, TreClientVisitBranchlnOrder, 
TreCllentVisItPreOrder. TVeClientVisitChildren, TreCllentVisitlnOrder, 
TreCllentVisitlnOrderBwd, TreClientVisitDescBranchlnOrder. 
TreCUentVisltDescPreOrder, TreCUentVisitDescInOrder, 
TreClientVisitDescInOrderBwd, TVeClientVisitLeaves, TreClientVisitParents. 
TreCllentVisltRange. TreClientVisitSuccessors 

Diagram 



Walk the Tree for all Children Backwards 

pTre 




O Element Not Visited 
First 



Element Visited and Order 

Last 
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TreClientVisitDescBranchlnOrder 



Summary 

#include "cobjects.h" 
#lnclude "tremac.h" 

Void TreOientVisitDescBranchInOrder( pTre, offset, pBlk ) 

PTRE pTre; 
Meditimint offset; ' 
PBLK pBlk; 

Public Function 

Purpose 

The TreClientVisitDescBranchlnOrder function walks a TYee and calls the Tree 
client function for each tree node visited. The Tree is walked by calling 
TreCllentVisitBranchlnOrder for each of its children. The nodes are visited if 
th^ are branches (have children). 

The Block pBIk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function, 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitDescBranchlnOrder 



See Also 

TreClientVisitSuccPreOrder. TreClientVisitBranchlnOrder. 
TreClientVisitPreOrder, TreCllentVisitChUdren, TreClientVisitChildrenBwd, 
TreClientVisltlnOrder, TVeClientVisitlnOrderBwd, TreCUentVisltDescPreOrder, 
TreClientVisitDescInOrder, TreClientVisitDescInOrderBwd, 
TreClientVisitLeaves, TreClientVisitParents, TreClientVisltRange. 
IVeClientVisitSuccessors 

Diagram 



Walk the Tree descendent branches In-order 
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TreClientVisitDesclnOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 



Void TreaientVisitDescInOrder( pTrc, offset, pBlk ) 

PTRE pTre; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitDesclnOrder function walks the Tree and calls a Tree client 
function for each tree node visited. The Tree is walked by calling 
TreClientVisitlnOrder for the children of pTre. The nodes are visited in a 
forward direction. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTte - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in b3rtes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may retum a value but it is ignored. 
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TreClientVisitDesclnOrder 



See Als 

TreClientVlsltSuccPreOrder, TreClientVisitBranchlnOrder, 
TVeClientVisitPreOrder. TreCllentVisitChildren, TreCllentVisitChildrenBwd, 
TreCllentVisltlnOrder.TreClientVisitlnOrderBwd, 
TreClientVisitDescBranchlnOrder. TreClientVisitDescPreOrder, 
TreClientVisitDescInOrderBwd. TreClientVisitLeaves, TreClientVisitParents, 
TteClientVisitRange, TreCUentVisitSuccessors 

Diagram 



Walk the Tree Descendents In-order 
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TreClientVisitDesclnOrderBwd 



Summary 

#include "cobjects.h" 
#include "tremac.h" 



Void TreaientVisitDescInOrderBwd( pTre, offset, pBlk ) 

PTRE pTre; 

Mediumint offset: 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitDesclnOrderBwd function walks the Tree and calls a Tree 
client ftinction for each tree node visited. The Tree is walked by calling 
TreClientVisitlnOrderBwd for the children of pTre. The nodes are visited last to 
first. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The client fimction may return a value but it is ignored. 
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TreClientVisitDesclnOrderBwd 



See Als 

TreCllentVisitSuccPreOrder, TreCllentVisitBranchlnOrder, 
TVeClientVisltPreOrder, TreClientVlsitChildren. TreClientVisitChildrenBwd, 
TreClientVisitlnOrder, TVeCUentVisitlnOrderBwd, 
TreCllentVisitDescBranchlnOrder, TreClientVisitDescPreOrder, 
TreClientVisitDescInOrder, TreClientVisitLeaves, TreClientVisitParents, 
TreClientVisitRange, TreCUentVisitSuccessors 

Diagram 

Walk the Tree Descendents In-order backwards 




Tre-38 



TreClientVisitDescLeaves 



Summary 

#include "cobjects.h" 
#include "tremac.h" 



Void TreaientVisitDescLcaves( pTre, offset, pBlk ) 

PTRE pTre; 

Mediumint offset; 

PBLK pBlk; 



Private Function 

Purpose 

The TreClientVisitDescLeaves function walks the Tree and calls the Tree client 
ftinction for each tree node visited. The Tree is walked by calling 
TreClientVisitLeaves for each of its children. The nodes are visited if they are 
leaves (have no children). The nodes are visited in a forward direction. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and its 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No retum value 

Notes 

The client function may retum a value but it is ignored. 
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TreClientVisitDescLeaves 



See Also 

TVeCllentVisitSuccPreOrder, TreClientVisitBranchlnOrder, 
TreClientVisitPreOrder, TreCllentVlsitChlldren. TreClientVisitChildrenBwd. 
TreClientVisitlnOrder.TreCllentVisitlnOrderBwd, 
TreCllentVisitDescBranchlnOrder, TreClientVisitDescPreOrder, 
TreCllentVisitDescInOrder.TreClientVisitDescInOrderBwd, 
TVeClientVisitLeaves. TreClientVisitParents, TVeClientVisitRange, 
TreClientVisitSuccessors 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreClientVisitDescLeaves fianction. 



TrG-40 



TreClientVisitDescPreOrder 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 



Void TreQientVisitDescPieOrdeiC pTre, offset, pBlk ) 

FTRE pTre; 

Mediumlnt offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitDescPreOrder function walks the Tree and calls a Tree cUent 
function for each tree node visited. The Tree is walked by calling 
TreClientVisitPreOrder for each of its children. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

ofTset . - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function, 

offset: See the Ckzss Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The client function may return a value but it is ignored. 
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TreClientVisitDescPreOrder 



See Als 

TreClientVlsitSuccPreOrder, TreClientVisitBranchlnOrder, 
TreClientVisitPreOrder, TreClientVisitChildren, TreClientVisitChildrenBwd, 
TreCllentVisitlnOrder, TreClientVisltlnOrderBwd. 
TreCllentVlsitDescBranchlnOrder. TreCllentVisitDescInOrder. 
TreCllentVisltDescInOrderBwd, TreClientVisitLeaves, TreClientVisitParents, 
TVeCllentVlsltRange, TVeClientVisitSuccessors 

Diagram 

Walk the Tree Descendents in Pre-order 




O Elemenl Not Visited (n) Element Visited and Order 

First Last 
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TreClientVisitlnOrder 



Summary 

#lnclude "cobjects.h" 
#lnclude "tremac.h" 

Void TreOientVisitlnOrderi pTre, offset, pBlk ) 

PTRE pTre; 
Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The TreClientVisitlnOrder function walks a Tree and calls the Tree client 
function for each tree node visited. The Tree is walked by calling 
TreClientVisitlnOrder recursively for the children of pTre, and then visiting 
pTre itself. The nodes are visited in a forward direction. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or nega;tive. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitlnOrder 



See Also 

TreClientVisitSuccPreOrder, TreCHentVisitBranchlnOrder, 
TreClientVisitPreOrder, TVeClientVisitChildren. TreClientVisitChildrenBwd. 
TreCUentVisltlnOrderBwd, TreClientVisitDescBranchlnOrder, 
TreCUentVisItDescPreOrder, TreClientVisitDescInOrder, 
TreClientVisitDescInOrderBwd. TVeClientVisitLeaves. TreClientVisitParents. 
TVeCUentVisltRange, TreClientVlsitSuccessors 

Diagram 



Walk the Tree In-order 
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TreClientVisitlnOrderBwd 



Summary 

#lnclude "cobjects.h " 
#include "tremac.h" 

Void TreaientVisianOrderBwd( pTre, offset, pBlk ) 

FTRE pTre; 
Mediumint offset; 
PBLK pBlk; 

Public Function 

Purpose 

The TreClientVisitlnOrderBwd function walks a Tree and calls the Tree client 
function for each tree node visited. The Tree is walked by calling 
TreClientVisitlnOrderBwd recursively for the children of pTre, and then visiting 
pTre itself. The nodes are visited last to first. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTlre - Pointer to a structure of type Tree. The root of a tree 
walk, 

offset - The distance in bytes between the Tree pTre and its 
client pointer. The \^ue must be 0 or negative. 

pBlk - Pointer to structure of ^e Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Vaiue 

No return value 
Notes 

The client function may return a value but it is ignored. 
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TreClientVisitlnOrderBwd 



See Also 

TreClientVisitSuccPreOrder, TreClientVisitBranchlnOrder, 
TreCUentVisitPreOrder, TreClientVisitChildren. TreClientVisitChildrenBwd. 
TreClientVisitlnOrder. TreClientVisitDescBranchlnOrder, 
TreClientVlsltDescPreOrder, TreCllentVisitDescInOrder, 
TreClientVisitDescInOrderBwd. TreClientVisitLeaves, TreClientVisitParents, 
TteClientVisltRange, "n-eClientVlsitSuccessors 

Diagram 



Walk the Tree In-order backyrairds 
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TreClientVisitLeaves 



Summary 

#include "cobjects.h" 
#lnclude "tremac.h" 

Void TreClientVisitLeaves( pTre, offset, pBlk ) 

VTRE pTre; 
Medlumint offset; 
PBLK pBlk; 

Public Function 

Purpose 

The TreClientVisitLeaves function walks the Tree and calls the Tree client 
function for each tree node visited. The function calls TreClientVisitLeaves 
recursively for each of its children. The nodes are visited if they are leaves 
(have no children). 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - Hie distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Vaiue 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitLeaves 



See Also 

TreClientVisitSuccPreOrder. TVeCllentVisitBranchlnOrder, 
TreCllentVisitPreOrder. TreCllentVlsitChlldren, TreClientVisitChildrenBwd, 
TreClientVisitlnOrder, TreCllentVisitlnOrderBwd, 
TreCllentVisitDescBranchlnOrder, TreClientVisitDescPreOrder, 
TreClientVisitDescInOrder, TreClientVisitDescInOrderBwd. 
TreClientVisltParents, TVeCUentVisitRange, TVeClientVisitSuccessors 

Diagram 



Walk the Tree for Leaves 




O Element Not Visited 0 Element Visited and Order 

first Last 
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TreClientVisitParents 



Summary 

#include "cobjects.h" 
#include "tremac.h" 



Void TrcaientVisitParents( pTre, offset, pBlk ) 

PTOE pTVe; 

Mediumint offset: 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitParents function v^lks a Tree and calls the Tree client 
function for each tree node visited. The Tree is walked by calling 
TreClientVisitParents recursively for the parent of pTre. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Btocfc which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The client function may return a value but it is ignored. 
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TreClientVisitParents 



See Also 

TreClientVisitSuccPreOrder, TreClientVisitBranchlnOrder, 
TreCUentVisitPreOrder, TreClientVisitChildren, TreCllentVisitChUdrenBwd, 
TreCUentVisitlnOrder, TreClientVisitlnOrderBwd, 
TreClientVisltDescBranchlnOrder, TreClientVisitDescPreOrder, 
TreClientVIsitDescInOrder. TreClientVisitDescInOrderBwd, 
TreClientVisitLeaves, TreCllentVisitRange, TreClientVisitSuccessors 

Diagram 



Walk the Tree Nearest Parents First 




O Bement Not Visited 0 Element Visited and Order 

First Last 
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TreClientVisitPreOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 



Void TreaientVisitPreOrder( pTre, offset, pBlk ) 

PTRE pTre; 

Mediumint offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitPreOrder function walks a Tree and calls the Tree client 
function for each tree node visited. The walk visits pTre first and calls 
TreClientVisitPreOrder recursively for each of its children. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offset - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The client function may retum a value but it is ignored. 
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TreClientVisitPreOrder 



See Also 

TreClientVlsitSuccPreOrder, TreClienmsitBranchlnOrder, 
TreCllentVisitChildren. TVeCllentVlsitChlldrenBwd, TVeClientVisitlnOrder, 
TteCllentVlsitlnOrderBwd, TreClientVisitDescBranchlnOrder, 
TreClientVisitDescPreOrder, TreClientVisitDescInOrder, 
TVeClientVisitDescInOrderBwd, TreClientVisitLeaves, TreClientVisltParents, 
TreClientVisitRange, TreClientVisitSuccessors 

Diagram 



Walk the Tree in Pre- order 
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TreClientVisitRange 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 



Mediumint TreQientVisitRangeC pTreBeg, pTreEnd, offset, pBlk ) 

PTRE pTreBeg; 

FDRE pTreEnd: 

Mediumint offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitE^ange function walks the Tree and calls a Tree client 
function for each tree node visited. The Tree is walked for a range of sibling 
nodes, pTreBeg through pTreEnd. The siblings are visited in a forward 
direction. 

The Block pBlk contains the client function and an optional list of arguments. 

A range of tree nodes is defined as a beginning tree node and an ending tree 
node. The beginning node can equal the ending node. See Tree class section on 
range definition for more details. 

Parameter - Description 



pTreBeg - Pointer to a structure of type Tree. This is the first tree 
node in a range. 

pTreEnd - Pointer to a structure of type Tree. This is the last tree 
node in a range. 

offset - The distance in bytes between the Tree pTte and it's 
client pointer. The value must be 0 or negative. 

pBlk - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The retum value from the TreClientVisitRange function is the number of times 
tree nodes are visited. 
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TreClientVisitRange 



Notes 

The client function may return a value but it is ignored. 

[If pTreBeg does not equal plYeEnd then pTreBeg must precede pTreEnd.] 

See Also 

TreClientVisitSuccPreOrder, TreClientVlsitBranchlnOrder, 
TreCllentVisitPreOrder, TreCUentVisitChildren, TreClientVisitChildrenBwd, 
TreClientVisitlnOrder. TreClientVisitlnOrderBwd, 
TreCllentVisitDescBranchlnOrder, TreClientVisitDescPreOrder. 
TreClientVisltDescInOrder, TreCllentVisitDescInOrderBwd, 
TreClientVisitLeaves, TreClientVisitParents, TteClientVisitSuccessors 

Diagram 



Walk the Tree for a Range of Siblings 




O Element Not Visited ® Element Visited and Order 

First Last 
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TreClientVisitSuccPreOrder 



Summary 

#Include "cobjects.h" 
#include "tremac.h" 



Void TreaientVisitSuccPreOrdeT( pTre, offset, pBlk ) 

FTOE pTVe; 

Mediumint offset; 

PBLK pBlk; 



Public Function 

Purpose 

The TreClientVisitSuccPreOrder function walks the Tree and calls the Tree 
client function for each tree node visited. The Tree is walked starting with the 
pre-order successor to pTre and visits all pre-order successors of pTre. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The PreOrder 

successor to this node is the first visited, 
offset - The distance in bytes between the Tree pTre and it's 

client pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

ofTset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 
Notes 

The client function may return a value but it is ignored. 
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TreClientVisitSuccPreOrder 



See Also 

TreCllentVlsltBranchlnOrder, TreClientVisitPreOrder. TreCllentVlsitChlldren. 
TreCUentVisltChlldrenBwd, TreCUentVlsitlnOrder.TreCUentVisitlnOrderBwd, 
TreCUentVisltDescBranchlnOrder, TreClientVisitDescPreOrder, 
TreCllentVisltDescInOrder, TreCllentVisitDescInOrderBwd, 
TreClientVisltLeaves, TreClientVisitParents, TteClientVIsitRange, 
TreCllentVIsitSuccessors 

Diagram 



Walk the Tree, all successors in Pre- order 




O Element Not Visited © Element Visited and Order 

First Last 
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TreClientVisitSuccessors 



Summary 

#include "cobjects.h" 
#lnclude "tremac.h" 

Void TreOientVisitSuccessois( pTre, offset, pBlk ) 

PTRE pTre; 
Mediiimlnt offset; * 
PBLK pBlk; 

Public Function 

Purpose 

The TreClientVisitSuccessors function walks the Tree and calls a Tree client 
function for each tree node visited. The Tree is walked in a forward direction for 
all successors and starts with the tree node that is the next sibling to pTre. 

The Block pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

offeet - The distance in bytes between the Tree pTre and it's 
client pointer. The value must be 0 or negative. 

pBUc - Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
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TreClientVisitSuccessors 



See Als 

TreCllentVisitSuccPreOrder, TreClientVisitBranchlnOrder, 
TreClientVisitPreOrder, TreCllentVlsitChildren. TreCHentVisitChlldrenBwd, 
TreCllentVisitlnOrder.'IVeCllentVlsitlnOrderBwd. 
TreClientVlsitDescBranchlnOrder. TreClientVisitDescPreOrder, 
TreCllentVisitDescInOrder. TreClientVisltDescInOrderBwd, 
TreClientVisitLeaves, TteClientVlsitParents, TreClientVisitRange 

Diagram 



Walk the Tree for Successors 
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TreCutChildren 



Summary 

#include "cobjects.h" 
#lnclude "tremac.h" 

Void TreCutChadien( pTre ) 

PTRE pTre: 

Public Function 

A macro is available for this function 

Purpose 

The TreCutChildren function unlinks any children of the Tree pTre from the 
Tree. 

Parameter - Description 

pTre - Pointer to a structure of type Tree, 
Return Value 

No return vsdue 

See Aiso 

TreCutRange. TrePasteRangeFirstChild, TrePasteRangeLastChild, 
TrePasteRangeAfterSibling, TrePasteRangeBeforeSibling 
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TreCutChildren 



Diagram 



Cut all Children from the Tree 
Before 




After 




Siblings and Children 
remain linked 



Tre-60 



TreCutRange 



Summary 

#lnclude "cobjects.h' 
#Include "tremac.h" 



Void 

PTRE 

PTRE 



TreCutRange( pTreBeg, pTreEnd ) 

pTreBeg: 

pTreEnd; 



Public Function 

A macro is available for this function 

Purpose 

The TreCutRange function unlinks a range of Tree nodes pTteBeg through 
pTreEnd from the Tree. The tree node preceding pTreBeg will be Unked to the 
sucessor tree node of pTreEnd. The range pTreBeg through pTreEnd become 
roots but the sibling connections remain. 

A range of tree nodes is defined as a beginning tree node and an ending tree 
node. The begirming node can equal the ending node. See Tree class section on 
range definition for more details. 

Parameter - Description 



pTreBeg - Pointer to a structure of type Tree. This is the first tree 

node to cut from the tree. 
pTreEnd - Pointer to a structure of type Tree. This is the last tree 

node to cut from the tree. 

Return Value 

No return value 
Notes 

Bf pTreBeg does not equal pTreEnd then pTreBeg must precede pTreEnd.] 

See Also 

TreCutChildren, TrePasteRangeFfrstChild, TrePasteRangeLastChild, 
TrePasteRangeAfterSiblIng, TrePasteRangeBeforeSlbllng 
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TreCutRange 

Diagram 

Cut a Range from the Tree 
Before 
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TreDelnit 



Summary 

#lnclude "cobjects.h' 
#lnclude "tremac.h" 



Void 
FTRE 



TreDelnitC pTre ) 
pTre; 



Public Function 

Purpose 

The TreDelnit function deinitializes the Tree object. The TreDelnit function 
should be the last function called when using the Tree class. 



Return Value 

No return value 
Notes 

The first function to call when using the Tree class is Trelnit. 
IpTre must be the root node.] 
[pTre must have no child nodes.] 

See Also 

TreDestroy, TreDestroyChildren, Trelnit 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreDelnit function. 



Parameter - Description 



pTre 



Pointer to a structure of type Tree. 
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TreDestroy 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 

Void TreDestroy( pTre ) 

FTRE pTre; 

Public Function 

Purpose 

The TreDestroy function deallocates the memory used by the object and 
deinitiallzes the Tree object. The Tree pTre should not be referenced after this 
function call since its memory will have been deallocated. 

The Tree pTre and any children of pTre will be cleared prior to deinltializing 
pTre. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

No return value 

Notes 

(pTre must not have a sub-object.] 

See Also 

TreDelnit, TreDestroyChildren, Trelnit 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreDestroy function. 
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TreDestroyChildren 



Summary 

#include "cobjects.h' 
#include "tremac.h" 



Void 
PTRE 



TreDestroyChildien( pTre ) 
pTre; 



Public Function 



Purpose 



The lYeDestroyChildren functioii sends a message to the clients of any children 
of the Tree pTre to destroy themselves. 

Parameter - Description 



Return Value 

No return value 
See Also 

TreClearChlldren 

Example 

Please refer to class test procedure TSTTFiE.C for an example of the use of the 
TreDestroyChildren function. 



pTre 



Pointer to a structure of type Tree. 
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TreFirstChild 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

PTRE TreFirstChild( pTre ) 

PTRE pTre; 

Private Function 

A macro is available for this function 

Purpose 

The TteFirstChlld function returns the first child of the Tree pTre. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

The return value firom the TreFirstChild function is a pointer to the first child 
of the Tree pTre. NULL is returned if there are no children. 

See Also 

TreLastChild, TreLastLeaf, TreNext, TreNextUncle, TreNextPreOrder, TreParent, 
TrePrev, TrePrevPreOrder 
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I 
I 



TreFirstChild 



Diagram 



First Child of pTre 



First Child 

First 




Last 
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TreHasChildren 



Summary 

#include "cobjects.h' 
#include "tremac.h" 



Bool 
PTE^ 



TreHasChildien( pTre ) 
pTre: 



Public Function 

A macro Is available for this function 



Purpose 

The TreHasChildren function determines if the Tree pTre has any children. 

Parameter - Description 



Return Value 

The return value from the TreHasChildren function is True if the Tree pTre has 
any children, otherwise False Is returned. 

See Also 

TreHasSlblings, TrelsChild, TrelsRoot, TrelsDlrectAncestor 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreHasChildren fiinction. 



pTre 



Pointer to a structure of type Tree. 
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TreHasSiblings 



Summary 

#include "cobjects.h' 
#include "tremac.h" 



Bool 

PTRE 



TreHasSiblings( pTre ) 

pTre: 



Public Function 

A macro is available for this function 



Purpose , 

The TreHasSiblings function determines if the Tree pTre has any siblings. 

Parameter - Description 



Return Value 

The return value from the TreHasSiblings function is True if the Tree pTVe has 
any siblings, otherwise False is returned. 

See Also 

TreHasChildren, TrelsChlld, TrelsRoot, TrelsDirectAncestor 



Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreHasSiblings function. 



pTre 



Pointer to a structure of type Tree. 



Example 
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Trelnit 



Summary 

#lnclude "cobjects.h' 
#include "tremac.h" 



Void 
FTRE 



Treliiit(pTre) 
pTre; 



Public Function 



Purpose 



The Trelnit function initializes the Tree object. The Trelnit function should be 
the first function called when using the Tree class. 

Parameter - Description 



Return Value 

No return value 

Notes 

The last function to call when using the Tree class is TreDelnit. 

See Also 

TreDelnit, TreDestroy 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
Trelnit function. 



pTre 



Pointer to a structure of type Tree. 
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TrelsChild 



Summary 

#include "cobjects.h' 
#Include "tremac.h" 



Bool 

PTRE 



TrelsChUd(pTre) 
pTre; 



Public Function 

A macro Is available for this function 



Purpose 

The TrelsChild function determines if the Tree pTre has a parent node. 

Parameter - Description 



Return Value 

The return value from the TrelsChild function is True if pTre has a parent, 
otherwise False is returned. 

See Also 

TreHasChildren, TYeHasSiblings, TrelsRoot, TrelsDirectAncestor 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TrelsChild function. 



pTre 



Pointer to a structure of type Tree, 
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TrelsDirectAncestor 



Summary 

#include "cobjects.h" 
#lnclude "tremac.h" 

Bool TreIsDirectAncestor(pTie,pTieA) 

PTRE pTre: 
PTRE pTreA; 

Public Function 

Purpose 

The TrelsDirectAncester function determines if the Tree pTre is a parent, grand 
parent, or any other direct ancestor of pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 
pTVeA - Pointer to a structure of type Tree. Hiis tree node 
should be direct ancestor of pTre. 

Return Value 

The return value from the TrelsDirectAncestor function is True if the Tree pTre 
is a parent, grand parent, or any other direct ancestor of pTre. 

See Also 

TreHasChildren, TreHasSiblings, TrelsChild, TrelsRoot 

Exampie 

Please refer to class test procedure TSTTRE,C for an example of the use of the 
TrelsDirectAncestor function. 
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TrelsRoot 



Summary 

#lndude "cobjects.h" 
#include "tremac.h" 

Bool TreIsRoot( pTre ) 

PTRE pTre; 

Public Function 

A macro is available for this function 

Purpose 

The TrelsRoot function determines if the Tree pTre has no parent. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

The return value from the TrelsRoot function is True if the Tree pTre has no 
parent node, otherwise False is returned. 

See Aiso 

TreHasChildren, TreHasSibllngs, TrelsChild, TrelsDirectAncestor 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TrelsRoot function. 
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TreLastChild 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

PTRE TreLastChild(pTre) 
PTRE pTre; 

Private Function 

A macro is available for this function 

Purpose 

Hie TVeFirstChild function returns the last child of the Tree pTre. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

The return value from the TreLastChild function is a pointer to the last child of 
the Tree pTre. NULL is returned if there are no children. 

See Aiso 

TreFirstChUd. TreLastLeaf, TreNext, TreNextUncle, TreNextPreOrder. 
TreParent, TrePrev, TrePrevPreOrder 



Tre - 74 




Tre-75 



TreLastLeaf 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

PTRE TreLastLeaf( pTrc ) 

FTRE pTre; 

Private Function 

Purpose 

The TreLastLeaf function returns the last leaf of the Tree pTre. The last leaf is 
found by calling TreLastLeaf recursively for the last child of pTre until a node is 
visited that has no children. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 
Return Value 

The return value from the TreLastLeaf function is a pointer to the last leaf of 
the Tree pTre. NULL is returned if there are no children. 

See Also 

TreFirstChild, TreLastChlld, TreNext, TreNextUncle, TreNextPreOrder, 
TreParent, TrePrev, TrePrevPreOrder 
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TreLastLeaf 



Diagram 



Last Leaf of pTre 




f| First Last 
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TreNext 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

PTRE TreNext( pTre ) 

PTRE pTre: 

Private Function 

A macro is available for this function 

Purpose 

The TreNext function returns the successor sibling of the Tree pTre. 

Parameter - Description 

pTVe - Pointer to a structure of type Tree. 

Return Value 

The return value from the TreNext function is a pointer to the successor sibling 
node of the Tree pTre. NULL is returned if there is no sibling. 

See Also 

TreFirstChild, TreLastChild, TreLastLeaf, TreNextUncle, TreNextPreOrder, 
TreParent, TrePrev, TrePrevPreOrder 
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TreNext 
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TreNextPreOrder 



Summary 

#include "cobjects.h' 
#include "tremac.h" 



PTRE 
FTOE 



TreNextPrcOrdcr( pTre ) 

pTre: 



Private Function 



Purpose 



The TreNextPreOrder function returns the pre-order successor of the Tree pTre. 
The pre-order successor is: 1) the first child of pTre; ii) the successor sibling of 
pTre; il) the uncle of pTre. 



Return Value 

The return value from the TreNextPreOrder function is a pointer to the pre- 
order successor of the Tree pTre. NULL is returned if there is no successor. 

See Also 

TreFirstChild, TreLastChild, TreLastLeaf, TreNext, TreNextUncle, TreParent, 
TrePrev, TrePrevPreOrder 



Parameter - Description 



pTre 



Pointer to a structure of type Tree. 
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TreNextPreOrder 



Diagram 

Next node of pTre in Pre- order 
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TreNextUncle 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

PTRE TreNextUndeC pTrc ) 

PTRE pTre; 

Private Function 

Purpose 

The TreNextUncle function returns the successor uncle of the TreepTre. The 
next uncle is found by taking the successor of the parent of pTre. If the parent 
has no successor the function TreNextUncle is caUed recursively until the root 
node is reached or an uncle is found. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 

Return Vaiue 

The return value from the TreNextUncle fianction is a pointer to the next uncle 
of tiie Tree pTre. NULL is returned if there is no uncle. 

See Also 

TreFirstChild, TreLastChild, TreLastLeaf, TreNext, TreNextPreOrder, TreParent, 
TrePrev, TrePrevPreOrder 
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TreNextUncle 



Diagram 



Successor Uncle of pTre 



pTK 




Hext Uncle 



First 



Last 
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TreParent 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 

PTRE TieParent( pTic ) 

PTRE pTre; 

Private Function 

A macro is available for this function 

Purpose 

The TreParent fianctlon returns the parent of the Tree pTre. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

The return value from the TreParent function is a pointer to the parent of the 
Tree pTre, NULL is returned if no parent node exists. 

See Also 

TreFirstChild. TreLastChild, TreLastLeaf, TreNext. TreNextUncle, 
TreNextPreOrder, TrePrev, TrePrevPreOrder 



Tre-84 



TreParent 



Diagram 



Parent of pTre 




First Ust 



Tre - 85 



TrePasteRangeAfterSibling 



Summary 

#include "cobjects.h" 
#include "tremac.h" 



Void 
PTRE 
PTRE 
PTRE 



TrePasteRangeAfteTSibling( pTre, pTreBeg, pTreEnd ) 

pTre; 

pTreBeg; 

pTreEnd; 



Public Function 

A macro is available for this function 



Purpose 



The TrePasteRanf^eAfterSibling function links the range of Tree nodes pTreBeg 
through pTreEnd as children of the parent of the Tree pTre. The range Is linked 
so that the nodes are the successor siblings of pTre. 

The tree node range must have been previously cut from a tree. 

A range of tree nodes is defined as a beginning tree node and an ending tree 
node. The beginning node can equal the ending node. See Tree class section on 
range definition for more details. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The appended tree 
node(s) become next sibllng(s) of this node. 

pTreBeg - Pointer to a structure of type Tree. This is the first tree 
node to paste into the tree as a sibling of pTre. 

pTreEnd - Pointer to a structure of type Tree. This is the last tree 
node to paste into the tree as a sibling of pTre. 

Return Value 

No return value 



Notes 



pTreBeg must have a set of successors one of which is pTireEnd. 
[pTre must be a parent.] 
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TrePasteRangeAfterSibling 



Notes (cont) 

(If pTreBeg does not equal pTreEnd then pTreBeg must precede pTreEnd.] 
[pTreBeg must be the root node.] 

See Also 

TreCutRange, TreCutChlldren, TrePasteRangeFlrstChild, 
TrePasteRangeLastChild, TrePasteRangeBeforeSibling 

Diagram 



Paste Range of Siblings to the Tree 




Range to Paste 
with Siblings and 
Children Unked 



pTre 



First 



6 




Before 



Last 



pTreEnd 



Last 
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TrePasteRangeBeforeSibling 



Summary 

#include "cobjects-h" 
#include "tremac.h" 

Void TrePasteRange6eforeSibling( pTre, pTreBeg, pTreEnd ) 

PTOE pTre; 
PTOE pTreBeg: 
PTRE pTreEnd; 

Public Function 

A macro Is available for this ftinctlon 

Purpose 

The TrePasteRangeBeforeSibling function links the range of Tree nodes 
pTreBeg through pTreEnd as children of the parent of the Tree pTre. The range 
is linked so that the nodes are the predecessor siblings of pTre, 

TTie tree node range must have been previously cut from a tree. 

A range of tree nodes is defined as a beginning tree node and an ending tree 
node. The beginning node can equal the ending node. See Tree class section on 
range definition for more details. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The inserted tree 
node(s) become previous sibling(s) of this node. 

pTreBeg - Pointer to a structure of type Tree. This is the first tree 
node to paste into the tree as a previous sibling of 
pTre. 

pTreEnd - Pointer to a structure of type Tree. This is the last tree 
node to paste into the tree as a previous sibling of 
pTre. 

Return Value 

No return value 

Notes 

pTreBeg must have a set of successors one of which is pTreEnd. 
IpTte must be a parent.] 
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TrePasteRangeBeforeSibling 



Notes (cont) 

[If pTteBeg does not equal pTreEnd then pTteBeg mi^st precede pTreEnd.] 
[pTteBeg must be the root node.] 

See Also 

TreCutRange, TreCutChlldren, TrePasteRangeLastChild, 
TrePasteRangeFirstChild. TtePasteRangeAfterSibllng 

Diagram 

Paste Range of Siblings to the Tree 
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TrePasteRangeFirstChild 



Summary 

#include "cobjects.h' 
#lnclude "tremac.h" 



II 



Void 
PTRE 
PTRE 
PTRE 



TrePasteRangeFiistChild( pTre, pTreBeg, pTreEnd ) 

pTre; 

pTreBeg: 

pTVeEnd; 



Public Function 

A macro is available for this function 



Purpose 



The TrePasteRangeFirstChild function links a range of the Tree nodes pTreBeg 
through pTreEnd to the Tree pTre. The range is linked so that pTreBeg is the 
first child of pTre. 

The tree node range must have been previously cut from a tree. 

A range of tree nodes is defined as a beginning tree node and an ending tree 
node. The beginning node can equal the ending node. See Tree class section on 
range definition for more details. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The inserted tree 
node(s) become the first children) of this node. 

pTreBeg - Pointer to a structure of type Tree. This is the first tree 
node to paste into the tree as a child of pTre. 

pTreEnd - Pointer to a structure of type Tree. This is the last tree 
node to paste into the tree as a child of pTre. 

Return Value 

No return value 



pTreBeg must have a set of successors one of which is pTreEnd. 

(If pTreBeg does not equal pTreEnd then pTreBeg must precede pTreEnd.] 

[pTreBeg must be the root node.] 



Notes 
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TrePasteRangeFirstChild 



See Also 

TreCutRange, TreCutChildren, TrePasteRaiigeLastChild, 
TrePasteRangeAfterSIblIng, TrePasteRangeBeforeSiblIng 

Diagram 

Paste Range of Children to the Tree 
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Tr e Paste Range LastCh i Id 



Summary 

#include "cobjects.h' 
#include "tremac.h" 



Void 

PTRE 
PTRE 
PTRE 



TreFasteRangeLastChild( pTie, pTieBeg, pTieEnd ) 

pTre; 

pTreBeg; 

pTVeEnd; 



Public Function 

A macro is available for this function 



Purpose 



The TrePasteRangeLastChlld function links a range of the Tree nodes pTreBeg 
through pTreEnd to the Tree. The range is linked so that pTreEnd is the last 
child of pTte. 

The tree node range must have been previously cut from a tree. 

A range of tree nodes is defined as a beginning tree node and an ending tree 
node. The beginning node can equal the ending node. See TYee class section on 
range definition for more details. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The appended tree 
node(s) become the last cmld(ren) of this node. 

pTreBeg - Pointer to a structure of type Tree. This is the first tree 
node to paste into the tree as a child of pTre. 

pTreEnd - Pointer to a structure of type Tree. This is the last tree 
node to paste into the tree as a child of pTre. 

Return Value 

No return value 



pTreBeg must have a set of successors one of which is pTreEnd. 

[If pTreBeg does not equal pTreEnd then pTreBeg must precede pTreEnd.] 

(pTreBeg must be the root node.] 



Notes 
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TrePasteRangeLastChild 



See Also 

TreCutRange, TreCutChlldren. TrePasteRangeFirstChild, 
TrePasteRangeAfterSiblIng, TrePasteRangeBeforeSibling 

Diagram 



Paste Range of Children to the Tree 
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TrePrev 



Summary 

#include "cobjects.b" 
#include "tremac.h" 

PTRE TrePrev( pTre ) 

PTRE pTre: 

Private Function 

A macro Is available for this function 

Purpose 

The TrePrev function returns the preceding sibling of the Tree pTre. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

The return value from the TrePrev function is a pointer to the preceding sibling 
of IJie Tree pTre. NULL is returned if no previous sibling exists. 

See Also 

TreFirstChild, TreLastChlld, TreLastLeaf, TreNext, TreNextUncle, 
TreNextPreOrder, TYeParent, TrePrevPreOrder 
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TrePrev 



Diagram 

Preceding Sibling of pTre 




First Lftst 
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TrePrevPreOrder 



Summary 

#lnclude "cobjects.h" 
#lnclude "tremac.h" 

PTRE TrePrevPreOrder( pTrc ) 

PTRE pTre; 

Private Function 

Purpose 

The TrePrevPreOrder function returns the client of the pre-order predecessor 
the Tree pTre. The pre-order predecessor is the previous sibling of pTre. If pTre 
has no previous sibling the function TVeClientPrevPreOrder is called recursively 
for the parent of pTre. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. 

Return Value 

The return value from the TrePrevPreOrder function is a pointer to the pre- 
order predecessor of the Tree pTre. NULL is returned if no node exists. 

See Aiso 

TreFirstChild, TreLastChild. TreLastLeaf, TreNext, TreNextUncle. 
TreNextPreOrder, TreParent, TrePrev 
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TrePrevPreOrder 



Diagram 

Previous node of pTre in Pre- order 
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TreSend Destroy 



Summary 

#include "cobjects.h" 
#lnclude "tremac.h" 

Void TreSendDcstroy( pTre ) 

PTRE pTre: 

Public Function 

Purpose 

The TreSendDestroy function sends a message to the client of the Tree pTre 
asking It to destroy the tree node. The Tree client function will receive this 
message and should deinitialize or destroy the edge. This message function 
should be included in the Tree client message array. 

Parameter - Description 

pTre - Pointer to a structure of type Tree. 

Return Value 

No return value 

Example 

Please refer to class test procedure TSTTRE.C for an example of the use of the 
TreSendDestroy function. 
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TreVisitBranchlnOrder 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 

Void TreVisit6ranchInOrder( pTie, pBlk ) 

PTRE pTre: 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitBranchlnOrder function wsdks a Tree and calls a Tree function for 
each tree node visited. The tree is walked by calling TreVisitBranchlnOrder 
recursively for each of its children, and then Artsting pTre itself. The nodes are 
visited if mey are branches (have children). 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of iype Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block: which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 
Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitPreOrder, TreVisitChildren, 
TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TJreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitParents, TreVisitRange, 
TreVisitSuccessors 
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TreVisitBranchlnOrder 



Diagram 



Walk the Tree branches In-order 
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TreVisitChildren 



Summary 

#inclucle "cobjects.h" 
#include "tremac.h" 

Void TreVisitChildren( pTre, pBlk ) 

PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitChildren function walks the Tree and calls a Tree function for each 
tree node visited. The Tree is walked for each of the children of the Tree pTre 
starting with its first child and ending with its last child. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may return a value but it is ignored. 
See Also 

TreVisitSuccPreOrder. TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitParents, TreVisitRange, 
TreVisitSuccessors 



Tre-101 



TreVisitChildren 



Diagram 

Walk the Tree for all Children 




Tre - 102 



TreVisitChildrenBwd 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 

Void TreVisitChUdrenBwd(pTre,pBlk) 
PTRE pTre: 
PBLK pBlk: 

Private Function 

Purpose 

The TreVisitChildrenBwd function walks the Tree and calls a Tree function for 
each tree node visited. The Tree is walked for each of the children of the Tree 
pTre starting with its last child and ending with its first child. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Vaiue 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder. 
TreVisitChildren, TreVisitlnOrder, TreVisitlnOrderBwd. 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitParents, TreVisitRange, 
TreVisitSuccessors 
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TreVisitChildrenBwd 



Diagram 



Walk the Tree for all Children Backwards 
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TreVisitDescBranchinOrder 



Summary 

#lnclude "cobjects.h" 
#lnclude "tremac.h" 

Void TreVisitDescBranchInOrder( pTre, pBlk ) 

FTRE pTre: 
PBLK pBlk: 

Private Function 

Purpose 

The TreVisitDescBranchinOrder function walks the Tree and calls a Tree 
function for each tree node visited. The Tree is walked by calling 
TreVisitBranchlnOrder for each of its children. The nodes are visited if they are 
branches (have children). 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder. 
TreVisitChildren, TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescPreOrder, TreVisitDescInOrder, TreVisitDescInOrderBwd, 
TreVisitLeaves, TreVisitParents, TteVisitRange, TreVisitSuccessors 
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TreVisitDescBranchlnOrder 



Diagram 



Walk the Tree Descendenl branches In-order 




O Element Not Visited 0 Element Visited and Order 

First Last 
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TreVisitDesclnOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreVisitDescInOrder( pTre, pBlk ) 

PTRE pTre; 
PBLK pBlk: 

Private Function 

Purpose 

The TYeVisitDescInOrder function walks the Tree and calls a Tree function for 
each tree node visited. The Tree is walked by calling TreVisitlnOrder for the 
children of pTre. The nodes are visited in a forward direction. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder. TreVisitPreOrder, 
TreVisitChildren, TreVisitChildrenBwd, TreVisitlnOrder. TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrderBwd, 
TreVisitLeaves, TreVisitParents, TreVisitRange, TreVisitSuccessors 
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TreVisitDesclnOrder 



Diagram 



Walk the Tree Descendents In-order 
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TreVisitDesclnOrderBwd 



Summary 

#taclude "cobJects.h" 
#include "tremac.h" 

Void TreVisitDescInOrderBwd( pTre, pBlk ) 

PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitDesclnOrderBwd function walks the Tree and calls a Tree function 
for each tree node visited. The Tree is w£dked by calling TreVisitlnOrderBwd for 
the children of pTre. The nodes are visited in a backward direction. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder. 
TreVisitChildren. TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder. 
TreVisitLeaves, TreVisitParents. TreVisitRange, TreVisitSuccessors 
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TreVisitDesclnOrderBwd 



Diagram 

Walk the Tree Descendents In-order backwards 
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TreVisitDescPreOrder 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 

Void TreVisitDescPreOrderCpTie^pBlk) 
PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitDescPreOrder function walks the Tree and calls a Tree function for 
each tree node visited. The Tree is walked by calling TreVisitPreOrder for each 
of its children. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Vaiue 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Aiso 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder. 
TreVisitChildren, TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescInOrder, TreVisitDescInOrderBwd, 
TreVisitLeaves, TreVisitParents, TreVisitRange, TreVisitSuccessors 
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TreVisitDescPreOrder 



Diagram 

Walk the Tree Descendenls in Pre- order 
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TreVisitlnOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreVisitInOrder(pTre,pBlk) 
VTBE pTre; 
PBLK pBlk; 

Private Functlcm 

Purpose 

The TreVisitlnOrder function walks the Tree and calls a Tree function for each 
tree node visited. The Tree is walked by calling TreVisitlnOrder recursively for 
the children of pTre, and then visiting pTre itself. The nodes are visited in a 
forward direction. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type TYee. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildren, TreVisitChildrenBwd, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVlsitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitParents, TreVisitRange, 
TreVisitSuccessors 
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TreVisitlnOrder 



Diagram 

Walk the Tree In-order 




O Element Not Visited © Element Visited and Order 

First Last 
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TreVisitlnOrderBwd 



Summary 

#lnclude "cobjects.h" 
#include "tremac.h" 

Void TreVisitInOrderBwd(pTre,pBlk) 
PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitlnOrderBwd function walks the Tree and calls a Tree function for 
each tree node visited. The Tree is walked by calling TreVisitlnOrderBwd 
recursively for the children of pTre, and then visiting pTre itself. The nodes are 
visited in a backward direction. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 
Notes 

The tree function may return a value but it is ignored. 

See Aiso 

TreVlsltSuccPreOrder, TVeVlsitBranchlnOrder. TreVisitPreOrder, 
TreVisitChildren, TreVisitChildrenBwd, TreVisitlnOrder, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisltDescInOrderBwd, TYeVlsitLeaves, TreVisitParents. TreVisitRange, 
TreVisitSuccessors 
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TreVisitlnOrderBwd 



Diagram 

Walk the Tree In-order backwards 




O Elemenl Not Visited @ Element Visited and Order 

First Last 
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TreVisitLeaves 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreVisitLeaves( pTre, pBlk ) 

PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitLeaves function walks the Tree and calls the Tree function for each 
tree node visited. The function calls TreVisitLeaves recursively for each of its 
children. The nodes are visited if they are leaves (have no children). 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTire - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 

Notes 

The tree function may rettirn a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TVeVisitPreOrder, 
TreVisitChildren, TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitParents, TreVisitRange, TreVisitSuccessors 
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TreVisitLeaves 



Diagram 

Walk the Tree for Leaves 
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TreVisitParents 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreVisitParents(pTre,pBlk ) 

PTRE pTre; 
PBLK pBlk: 

Private Function 

Purpose 

The TreVisitParents function walks the Tree and calls a Tree function for each 
tree node visited. The Tree is walked by calling TreVisitParents recursively for 
the parent of pTre. 

The Block pBUc contains the tree function and an optional list of arguments. 

Parameter - Description 



pTte - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Vaiue 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder. TreVisitPreOrder, 
TVeVisitChildren, TreVisitChildrenBwd, TVeVisitlnOrder, TreVisitlnOrderBwd. 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitRange. TreVisitSuccessors 
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TreVisltParents 



Diagram 

Walk the Tree Nearest Parents First 
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TreVisitPreOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreVisitPreOrder(pTre,pBlk) 
PTRE pTre; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitPreOrder function walks the Tree and calls a Tree function for each 
tree node visited. The walk visits pTre first and calls TreVisitPreOrder 
recursively for each of its children. 

The Block pBUc contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parsimeters to be 
sent to the function. 

Return Vaiue 

No return value 
Notes 

The tree function may return a value but it is ignored. 

See Also 

TireVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitChildren, 
TreVisitChildrenBwd. TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitParents, TreVisitRange, 
TreVlsitSuccessors 
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TreVisitPreOrder 



Diagram 



Walk the Tree in Pre- order 




O Element Not Visited 0 Element Visited and Order 

First Last 
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TreVisitRange 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Mediiunint TreVisitRange( pTreBeg, pTreEnd, pBlk ) 
PTRE pTreBeg; 
PTRE pTreEnd; 
PBLK pBlk: 

Private Function 

Purpose 

The TreVisitRange function walks the Tree and calls a Tree function for each 
tree node visited. The Tree is walked for a range of sibling nodes, pTreBeg 
through pTreEnd. The siblings are visited in a forward direction. 

The Block pBlk contains the tree function and an optional list of arguments. 

A range of tree nodes is defined as a beginning tree node and an ending tree 
node. Hie beginning node can equal the ending node. See Tree class section on 
range definition for more details. 

Parameter - Description 



pTreBeg - Pointer to a structure of type Tree. This is the first tree 
node in a range. 

pTreEnd - Pointer to a structure of type Tree. This is the last tree 
node in a range. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

The return value from the TreVisitRange function is the number of times tree 
nodes are walkd. 

Notes 

The tree function may return a value but it is ignored. 

[If pTreBeg does not equal pTreEnd then pTreBeg must precede pTteEnd.] 
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TreVisitRange 



See Als 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChlldren, TreVisitChildrenBwd, TreVisitlnOrder, TreVisitlnOrderBwd, 
TreVisltDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TVeVisitLeaves, TVeVlsitParents, TreVlsitSuccessors 

Diagram 



Walk the Tree for a Range of Siblings 
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TreVisitSuccPreOrder 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreVisitSuccPieOrder(pTre,pBlk) 

PTE^ pTre; 
PBLK pBlk: 

Private Function 

Purpose 

The TreVisitSuccPreOrder function walks the Tree and calls a Tree function for 
each tree node visited. The Tree is walked starting with the pre-order successor 
to pTre and visits £dl successors of pTte. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTre - Pointer to a structure of type Tree. The PreOrder 
successor to this node is first visited. 

pBlk - Pointer to structure of type Block which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Vaiue 

No return value 

Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitBranchlnOrder. TreVisitPreOrder, TreVisitChildren, 
TreVisitChildrenBwd. TreVisitlnOrder, TYeVisitlnOrderBwd, 
TreVisitDescBranchlnOrder, TVeVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisitLeaves, TreVisitParents, TreVisitRange, 
TreVisitSuccessors 
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TreVisitSuccPreOrder 



Diagram 



Walk the Tree for all successors in Pre- order 
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TreVisitSuccessors 



Summary 

#include "cobjects.h" 
#include "tremac.h" 

Void TreVisitSuccessors( pTre, pBIk ) 

PTOE pTVe; 
PBLK pBlk; 

Private Function 

Purpose 

The TreVisitSuccessors function walks the Tree and calls a Tree function for 
each tree node visited. The Tree is walked in a forward direction for all 
successors and starts with the tree node that is the next sibling to pTre. 

The Block pBlk contains the tree function and an optional list of arguments. 

Parameter - Description 



pTVe - Pointer to a structure of type Tree. The root of a tree 
walk. 

pBlk - Pointer to structure of type Block: which contains the 
tree function to call and any optional parameters to be 
sent to the function. 

Return Value 

No return value 
Notes 

The tree function may return a value but it is ignored. 

See Also 

TreVisitSuccPreOrder, TreVisitBranchlnOrder, TreVisitPreOrder, 
TreVisitChildren. TVeVisitChlldrenBwd. TreVisitinOrder, TreVisitinOrderBwd, 
TreVisitDescBranchlnOrder, TreVisitDescPreOrder, TreVisitDescInOrder, 
TreVisitDescInOrderBwd, TreVisit Leaves, TreVisitParents, TreVisitRange 
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TreVisitSuccessors 



Diagram 

Walk the Tree for Successors 
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Class Reference for Task 



Structure Name: Task 

Abbreviation: Tsk 

Class Type: Primitive class 
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TskCondition 



Summary 

#include "cobjects.h" 
#lnclude "tskmac.h" 

Void TskCondition( pTsk, type, error, f ileName, lineNo ) 

PTSK pTsk; 
Ext type; 
Mediumlnt error; 
PSTR fileName; 
Mediumlnt lineNo; 

Public Function 

Puipose 

The TskCondition function checks the condition flag error and raises an 
exception if error is zero for the Task pTsk. The category of the condition type, 
the me name fileName and the line number in the file lineNo are passed to the 
fimction. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 

type - Condition category of exception. This will be defined by 

the choice of Task exception macro, 
error - If error is equal to zero an exception is trigged. If type 

is EXT_FORCED any value of error will trigger 

exception. 

fileName - Name of file where exception occured. 
lineNo - Line number in file where exception occured. 

Condition categories: 

EXr_PRECONDrnON Preconditions for execution, examples; function 

arguments, ranges, links. 
EXr_LX)GIC Conditions during execution of code, examples; 

logic errors, out of bounds. 
EXr_VALID_PTR Used for checking the check word of objects. 

EXr_FORCED Forced exception, value of error overriden, 

examples; error during read/write. 

Return Value 

No retum value 



Tsk-2 



TskCondition 



Notes 

An exception handler must have been established prior to calling this function. 
[The exception stack must not be empty for the Task pTsk.] 
[There must be no recursion of the exception.] 
(The condition category must be valid.] 

See Also 

TskLogCond, TskPreCond, TskPtrCond, TskRaiseException, TskMainLogCond, 
TskMainPreCond, TskMainPtrCond. TskMainRaiseException, 
TskPopExceptionHandler. TskOnEbcception 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C.TST5.C,TST6.C for an example of the use of the 
TskCondition function. 
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TskDelnit 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskDelniKpTsk) 
PTSK pTsk; 

Public Function 

Purpose 

The TskDelnit function deinitiallzes the Task object. The TskDelnit function 
should be the last function called when using the Task class. 

Parameter - Description 

pTsk - Pointer to a structure of type Task. 

Return Value 

No return value 

Notes 

The first function to call when using the Task class is Tsklnit. 

See Also 

TskDefaultlnit, Tsklnit 

Example 

Please refer to class test procedure 

TST1.C.TST2.C,TST3.C,TST4.C.TST5.C.TST6.C for an example of the use of the 
TskDelnit function. 
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TskDefaultlnit 



Summary 

#include "cobjects.h" 
#lnclude "tskmac.h" 

Void TskDef aultlnit( pTsk, argc, axgv ) 

PTSK pTsk; 
Mediumint argc; 
PSTR argvl]; 

Public Function 

Purpose 

The TskDefaultlnit function initializes the Task object. The TskDefaultlnit 
function should be the first function called when using the Task class. The 
user can also use the Tsklnit function which requires additional arguments. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 
argc - Argument count as passed by mainQ. 
argv - Argimient vector as passed by mainQ. 

Return Value 

No return value 

Notes 

The last function to call when using the Task class is TskExit, 
TskExitWithMsg, or TskNormalExit. 

See Also 

TskExit. TskExitWithMsg, Tsklnit, TskNormalExit 

Example 

Please refer to class test procedure 

TST1.C.TST2.C.TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskDefaultlnit function. 
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TskExit 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskExiK pTsk, exitVal ) 

PTSK pTsk; 
Mediumlnt exitVal; 

Public Function 

Purpose 

The TskExit function Is equivalent to the C function exltQ. The function 
delnitiallzes the Task pTsk and exits the task with the exit value exitVal. This 
function is equivalent to a class deinit function. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 
exitVal - Exit value to pass to the C exitO function. 

Return Value 

No return value 

Notes 

The TskExit function will be the last function called before returning to the 
operating system. 

See Also 

TskExitWithMsg. TskNormalExit 

Example 

Please refer to class test procedure 

TST1.C.TST2.C.TST3.C,TST4.C,TST5.C.TST6.C for an example of the use of the 
TskExit function. 
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TskExitWithMsg 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskExitWithMsg(pTsk,]nsg) 
PTSK pTsk; 
PSTR msg; 

Public Function 

Purpose 

Hie TskE3dtWthMsg function is equivalent to the C function exitO with a 
printf(msg) statement immediately before it. The function deinitializes the Task 
pTsk and exits the task with an exit value of 1. This function is equivalent to a 
class deinit function. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 
msg - Message string to print to the terminal using the C 
function printfTmsg). 

Return Value 

No return value 

Notes 

The TskExitWithMsg function will be the last function called before returning 
to the operating system. 

See Also 

TskExit, TskNormalExit 

Example 

Please refer to class test procedure 

TST1.C,TST2.C.TST3.C.TST4.C,TST5.C,TST6.C for an example of the use of the 
TskExitWithMsg function. 



Tsk-7 



TskGetArgc 



Summary 

#include "cobjects.h" 
#include "tskmach" 

Mediumlnt TskGetAigcC pTsk ) 
PTSK pTsk: 

Public Function 

Purpose 

The TskGetArgc function returns the argument count as supplied by mainO for 
the Task pTsk. 

Parameter - Description 

pTsk - Pointer to a structure of type Task. 

Return Value 
See Also 

TskOetArgv 

Example 

Please refer to class test procedure 

TST1.C.TST2.C,TST3.C.TST4.C,TST5.C,TST6.C for an example of the use of the 
TskGetArgc function. 
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TskGetArgv 



Summaty 

#include "cobjects.h' 
#include "tskmac.h" 



PSTR 

PTSK 



TskGetAigv( pTsk ) 
pTsk; 



Public Function 



Purpose 



The TskGetArgv function returns the argument vector as passed by mainO for 
the Task pTsk. 

Parameter - Description 



Return Value 

The return value from the TskGetArgv function is a pointer to a String pointer. 

See Aiso 

TskGetArgc 

Example 

Please refer to class test procedure 

TST1.C.TST2.C,TST3.C,TST4.C.TST5.C,TST6.C for an example of the use of the 
TskGetArgv function. 



pTsk 



Pointer to a structure of type Task. 
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TskGetExceptionCondition 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Mediumlnt TskGetExceptionCondition( pTsk ) 
PTSK pTsk; 

Public Function 

Purpose 

The TskGetExceptionCondition function returns the exception condition error 
value. 

Parameter - Description 

pTsk - Pointer to a structure of type Task. 

Return Value 

The return value from the TskGetExceptionCondition function is the exception 
condition error value. 

See Also 

TskGetExceptionFileName. TskGetExceptionlineNo, TskGetExceptionType 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskGetExceptionCondition function. 
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TskGetExceptionFileName 



Summary 

#include "cobjecvs.h" 
#include "tskmac.h" 

FSTR TskGetExceptionFileName( pTsk ) 

PTSK pTsk: 

Public Function 

Purpose 

The TskGetExceptionFileName function returns the filename where the 
exception was generated for the Task pTsk. 

Parameter - Description 

pTsk - Pointer to a structure of type Task. 

Return Value 

The return value firom the TskGetExceptionFileName function is the name of 
the C source code file where the exception occured. 

See Also 

TskGetExceptionLineNo, TskGetExceptLonCondition, TskGetExceptionType 

Example 

Please refer to class test procedure 

TSTl.C.TSTr2.C.TSTr3.C,TST4.C.TST5.C,TST6.C for an example of the use of the 
TskGetEixceptionFileName function. 
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TskGetExceptionLineNo 

Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Mediumint TskGetExceptionLmeNo( pTsk ) 
PTSK pTsk; 

Public Function 

Purpose 

The TskGetExceptionLineNo function returns the line number of the file where 
the exception was generated for the Task pTsk. 

Parameter - Description 

pTsk - Pointer to a structure of type Task. 

Return Value 

The return value from the TskGetExceptionLineNo function is the line number 
in a C source code file where the exception occured. 

See Also 

TskGetExceptionFileName, TskGetExceptionCondition, TskGetExceptionType 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskGetExceptionLineNo function. 
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TskGetExceptionType 



Summary 

#include "cobjects.h' 
#include "tskmac.h" 



Ext 

PTSK 



TskGetExceptionType( pTsk ) 
pTsk; 



Public Function 



Purpose 

The TskGetExceptionType function returns the exception type. 

Parameter - Description 



pTsk 



Pointer to a structure of type Task. 



Return Value 

The return value from the TskOetExceptionCondition function is the exception 
type. 

See Also 

TskOetExceptionFileName, TskOetExceptionLineNo. TskOetExceptionCondition 
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TskGetExceptionType 



Example 

Example of using an exception type: 

Void Tsl<Process( pTsk ) 
PTSK pTsk; 

Ext excType; 

TskAssert( pTsl< ); 



r Set up an exception handler for file I/O 7 

if ( TskOnException( TskMain ) ) { 
/* If an exception occurs, program control will jump to 7 
r this IF statement. The code within this IF statement 7 
/* will be used to report the exception 7 



r Find out the nature of the exception 7 
excType = TskGetExceptionType( TskMain ); 
if( excType = EXT_FORCED ) 
return TskExitWithMsg{ pTsk, "I/O En-or - program aborted" ); 



} ■ 



} * 
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Tsklnit 



Summary 



#include "cobjects.h" 
#include "tskmac.h" 



TsklniU pTsk, aigc, aigv, maxNesting, excFilter ) 

pTsk: 

argc: 

*argv; 

maxNesting; 
excFilter: 



Void 
PTSK 

Mediumint 
PSTR 

Mediumint 
ExcFilter 

Public Function 

Purpose 

The Tsklnlt function initializes the Task object. The Tsklnit function should be 
the first function called when using the Task class. 



Parameter 



Description 



pTsk 

argc 

argv 

maxNesting 
excFilter - 



Pointer to a structure of type Task. 
Argument count as passed by mainO- 
Argument vector as passed by mainO- 

Maximum nimiber of levels for nesting of 
exception handlers. 

Function to be called just prior to raising exception. If 
NULL no function is called. 



Return Value 

No return value 
Notes 

The last function to call when using the Task class is TskExit, 
TskExitWithMsg, or TskNormalExit. 

See Also 

TskDefaultlnit. TskExit, TskExitWithMsg, TskNonnalExit 
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Tsklnit 



Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C.TST4.C.TST5.C.TST6.C for an example of the use of the 
Tsklnit function. 
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TskLogCond 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskLogCond( pTsk, error ) 

PTSK pTsk; 
Mediumlnt error; 

Public Function 

This function Is ariiy available as a macro 

Purpose 

The TskLogCond function checks the condition flag error and raises an 
exception if error is zero for the Task pTsk. The condition type EXT_LOGIC, the 
file name fileName and the line number in the file lineNo are passed to the 
function. 

The TskLogCond is used throughout C+O to check for program logic errors or 
function specific conditions which should not arise. The production libraries 
turn off most logic checking. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 

error - If error is equal to zero an exception is trigged. 

Return Value 

No retum value 
Notes 

An exception handler must have been established prior to calling this function. 
Failure to do so results in program termination and a cryptic error message. 

See Also 

TskConditlon, TskPreCond, TskPtrCond, TskRaiseException, TskMainLogCond, 
TskMainPreCond, TskMainPtrCond, TskMainRaiseException, 
TskPopExceptionHandler, TskOnException, TskPropagateE^xception 
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TskLogCond 



Example 

Please refer to class test procedure 

TST1.C,TST2.C.TST3.C,TST4.C.TST5.C.TST6.C for an example of the use of the 
TskLogCond function. 
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TskMainLogCond 



Summary 

#inclucle "cobjects.h" 
#include "tskmac.h" 

Void TskMainLogCond( error ) 

Mediumint error; 

Public Function 

This function is only available as a macro 

Purpose 

The TskLogCond function checks the condition flag error and raises an 
exception if error is zero for the Task TskMain. The condition type EXT^LOGIC, 
the file name flleName and the line number in the file lineNo are passed to the 
function. 

The TskMainLogCond is used throughout C+O to check for program logic 
errors or function specific conditions which should not arise. The production 
libraries turn off most logic checking. 

Parameter - Description 



error - If error is equal to zero an' exception is trigged. 

Return Value 

No return value 

Notes 

An exception handler must have been established prior to calling this function. 
Failure to do so results in program termination and a cryptic error message. 

See Also 

TskCondition, TskLogCond, TskPreCond, TskPtrCond, TskRaiseException, 
TskMainPreCond, TskMainPtrCond, TskMainRaiseException, 
TskPopExceptionHandler, TskOnException, TskRropagateException 
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TskMainLogCond 



Example 

Example of using the TskMainLogCond function as used by the 
GrfClear function in C+0. 

Void GrfClear( pGrf ) 
PGRF pGrf; 

^ Bik bik; 

GrfAssert( pGrf ); 

Blklnit( &blk, (Method) VtxClear); 
GrfVisitVtxClient( pGrf, 0, &blk ); 
BlkDelnit( &blk ); 

r Failed to disconnect all vertices 7 

TskMainLogCond( DlllsEmpty( &pGrf->vtxList ) == True ); 

/* Failed to disconnect all edges V 

TskMainLogCond( DlllsEmpty( &pGrf->edgList ) » True ); 

DpaClear( &pGrf->fonvardSort ); 
DpaCiear( &pGrf->backwardSort }; 
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TskMainPreCond 



Summary 

#laclude "cobjects.h" 
#include "tskmac.h" 

Void TskMainFreCond( enor ) 

Mediumlnt error; 

Public Function 

This function Is only available as a macro 

Purpose 

The TskMainPreCond function checks the condition flag error and raises an 
exception If error Is zero for the Task TskMain. The condition type 
EXr_PRECONDrnON, the file name flleName and the line number In the file 
lineNo are passed to the function. 

The TskMainPreCond Is used tliroughout C+O to check for Illegal parameter 
values and other preconditions that must hold before attempting to execute the 
fijnction. The production libraries turn off most precondition checking. 

Parameter - Description 



error - If error Is equal to zero an exception is trigged. 

Return Value 

No return value 

Notes 

An exception handler must have been established prior to calling this function. 
Fsdlure to do so results in program termination and a cryptic error message. 

See Also 

TskLogCond, TskPreCond, TskPtrCond, TskRalseException, TskMainLogCond, 
TskCondltion, TskMalnPtrCond, TskMalnRalseException, 
TskPopExceptionHandler, TskOnExceptlon, TskPropagateExceptlon 
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TskMainPreCond 



ExampI 



Example of using the TskMainPreCond function as used by the 
LeITest function in C+0. 

Void LelTest{ pLel ) 
PLEL pLel; 

^ TskMainPreCond( pLel 1= NULL ); r pLei cannot be NULL */ 
LelAssert( pLel ); 

r The successor list element must point to pLel V 
if ( pLel->next ) 
TskMainPreCond( pLel->next->prev == pLel ); 

r The predecessor list element must point to pLel V 
if ( pLel->prev ) 
TskMainPreCond( pLel->prev->next == pLel ); 
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TskMainPtrCond 



Summary 

#include "cobjects-h" 
#include "tskmach" 

Void TskMamFtrCond( error ) 

Mediumint error; 

Public Function 

This function is only available as a macro 

Purpose 

The TskMainPtrCond function checks the condition flag error and raises an 
exception if error is zero for the Task TskMain. The condition type 
EXrVAUD.PTR, the file name fileName and the line number In the file lineNo 
are passed to the function. 

The TskMainPtrCond is used throughout C+O to check for illegal pointer values 
before attempting to execute the function. The production libraries turn off 
most precondition checking. 

TskMainPtrCond is most frequently used as part of the class pointer asserts 
found in the header files for each class. 

Parameter - Description 



error - If error is equal to zero an exception is trigged. 

Return Value 

No return value 

Notes 

An exception handler must have been established prior to calling this function. 
Failure to do so results in program termination and a cryptic error message. 

See Also 

TskLogCond, TskPreCond, TskPtrCond, TskRaiseException, TskMainLogCond, 
TskCondition, TskMainPreCond, TskMainRaiseException, 
TskPopExceptionHandler, TskOnElxception, TskPropagateException 
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TskMainPtrCond 



Example 

Example of using the TskMainRrCond function as used by the 
GrfAssert function in C+0. 

#define GrfAssert(pGrf) \ 

TskMainRrCond(pGrf->check==GRF_CHECK_WORD) 
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TskMainRaiseException 



Summary 

#include "cobj€cts.h" 
#include "tskmac.h" 

Void TskMainRaiseException( error ) 

Mediumint error; 

Public Function 

This function is only available as a macro 

Purpose 

The TskMainRaiseException function raises an exception unconditionally for 
the Task TskMain. The condition type EXT_FORCED, the file name fileName 
and the line number in the file lineNo are passed to the function. The signal 
error can be retrieved by the exception handler. 

TskMainRaiseException can be used to signal special conditions to an 
exception handler. 

Parameter - Description 



error - The signal value. 

Return Value 

No retum value 
Notes 

An exception handler must have been established prior to calling this function. 
Failure to do so results in program termination and a cryptic error message. 

See Also 

TskLogCond, TskPreCond, TskPtrCond, TskRaiseException, TskMainLogCond, 
TskMainPreCond. TskMainPtrCond. TskPopExceptionHandler. TskCondition, 
TskOnException, TskPropagateEScception 
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TskMainRaise Exception 



Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C.TST4.C,TST5.C,TST6.C for an example of the use of the 
TskMainRalseE^ception function. 
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TskNormalExit 



Summary 

#lnclude "cobjects.h' 
#include "tskmac.h" 



Void 
PTSK 



TskNonnalExit( pTsk ) 
pTsk; 



Public Function 



Purpose 



The TskNormalExit function is equivalent to the C function exitO. The function 
deinitializes the Task pTsk and exits the task -with the exit value zero. Hils 
function is equivalent to a dass deinit function. 

Parameter - Description 



Return Value 

No return value 

Notes 

The TskNormalExit function will be the last function called before returning to 
the operating system. 

See Also 

TskExit, TskExitWithMsg 

Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C,TST4.C,TST5.C,TST6.C for an example of the use of the 
TskNormalE^t fimction. 



pTsk 



Pointer to a structure of type Task. 
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TskOnException 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskOnException( pTsk ) 

PTSK pTsk; 

Public Function 

This function Is only available as a macro 

Purpose 

The TskOnException function sets up an exception handler for catching 
exceptions raised during program execution of Task pTsk. The semantics for 
TskOnException is much like the ANSI C functions setjmp/longjmp. The return 
value is 0 when the exception handler is first set-up and non-zero if an 
exception is caught. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 

Return Vaiue 

No return value 

Notes 

The call to TskOnException should alwaj^ be within an if statement with no 
other expressions. The body of the if statement is the exception handler. 

Before returning from the function which sets up an exception handler, that 
function must call TskPopExceptionHandler. The results are undefined if the 
user fails to do this. 

See Also 

TskLogCond, TskPreCond, TskPtrCond, TskRaiseException, TskMalnLogCond, 
TskMainPreCond, TskMainPtrCond, TskMainRaiseException, 
TskPopExceptionHandler, TskCondition, TskPropagateException 
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TskOn Exception 



Example 

Example of setting up a single level exception handier: 

int main( argc, argv ) 
int argc; 
char *argvn; 

{ 

r Initialize the Task using the default task TskMain 7 
TskDefaultlnit( TskMain, argc, argv ); 

r Set up an exception handler using the TskOnException call *l 

if ( TskOnException( TskMain ) ) { 
r If an exception occurs, program control will jump to V 
/* this IF statement. The code within this IF statement V 
/* will be used to report the exception V 



/* Exit the task with an error code */ 
return TskExit( TskMain, 1 ); 



/* Call the program code 7 
TskProcess( TskMain ); 

TskNormalExit( TskMain ); 
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TskPopExceptionHandler 



Summary 

#include "cobjects.h' 
#include "tskmac.h" 



Void 
PTSK 



TskPopExceptionHandler( pTsk ) 
pTsk; 



Public Function 



Purpose 



The TskPopExceptionHandler function pops to the exception handler stacked 
below this one for the Task pTsk. 



Return Value 

No return value 

Notes 

fThe exception stack must not be empty for the Task pTsk.] 
See Also 

TskLogCond, TskPreCond, TskPtrCond. TskRaiseException, TskMainLogCond, 
TskMainPreCond, TskMainPtrCond, TskMainRaiseException, TskOnException. 
TskPropagateExceptionHandler 



Parameter - Description 



pTsk 



Pointer to a structure of type Task. 



Tsk-30 



TskPopExceptionHandler 



Void TskProcess( pTsk ) 
PTSK pTsk; 

TskAssert( pTsk ); 

r Set Up a second exception handler for special errors V 
If ( TskOnExceptlon( pTsk ) ) { 

TskPrintException( TskMain ); 
} ■ 

i* If no exception was detected pop the stack prior to returning */ 
TskPopExceptionHandler( pTsk ); 
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TskPreCond 



Summary 

#lnclude "cobjects.h" 
#include "tskmac.h" 



Void 
PTSK 

Mediumlnt 



TskPieCond( pTsk, enror ) 

pTsk: 

error; 



Public Function 

This function is onfy available as a macro 



Purpose 



The TskPreCond function checks the condition flag error and raises an 
exception if error is zero for the Task pTsk. The condition type 
EXT_PRECONDrnON, the file name fileName and the line number in the file 
lineNo are passed to the function. 

The TskPreCond is used throughout C+O to check for illegal parameter values 
and other preconditions that must hold before attempting to execute the 
function. Hie production libraries turn off most precondition checking. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 

error - If error is equal to zero an exception is trigged. 

Return Value 

No return value 



An exception handler must have been established prior to calling this function. 
Failure to do so results in program termination and a cryptic error message. 

See Also 

TskCondition, TskLogCond, TskPtrCond, TskRaiseException. TskMainLogCond. 
TskMalnPreCond, TskMalnPtrCond, TskMainRaiseException, TskOnException, 
TskPropagateE^ceptionHandler 



Notes 
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TskPreCond 



Example 

Please refer to class test procedure 

TST1.C,TST2.C,TST3.C.TST4.C.TST5.C.TST6.C for an example of the use of the 
TskPreCond function. 
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TskPrintException 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskPiintExceptionC pTsk ) 

PTSK pTsk: 

Public Function 

Purpose 

The TskPrintException function prints the description of the exception. 

Parameter - Description 

pTsk - Pointer to a structure of type Task. 

Return Value 

No return value 
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TskPrintException 



Example 

Example of printing exception handler message: 

int main( argc, argv ) 
int argc; 
char *argvn; 

{ 

r Initialize the Task using the default task TskMain */ 
TskDefaultlnit( TskMain, argc, argv ); 

I* Set up an exception handler using the TskOnException call *l 
if ( TskOnException( TskMain ) ) { 



/* Print a message identifying the exception V 
TskPrintException( TskMain ); 

/* Exit the task with an en-or code */ 
return TskExit( TskMain, 1 ); 



} ' 
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TskPropagateException 



Summary 

#include "cobjects.h" 
#include "tskmac.h" 

Void TskFropagateException( pTsk, useFilter ) 

PTSK pTsk; 
Bool useFilter; 

Public Function 

Purpose 

The TskPropagateEIxception function will pass the last exception detected to the 
next exception handler for the Task pTsk. The useFilter flag determines 
whether the exception filter routine will be called. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 
useFilter - If True the exception filter routine defined in the 
Tsklnit call will be called. 

Return Vaiue 

No return value 
Notes 

[The exception stack must not be empty for the Task pTsk.] 
rrhere must be no recursion of the exception.] 
See Also 

TskLogCond, TskPreCond, TskPtrCond, TskRaiseException, TskMainLogCond, 
TskMainPreCond, TskMainPtrCond, TskMainRaiseException, TskCondition, 
TskOnEixception 
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TskPropagate Exception 



Example 

Example of using a multiple level exception handler: 

Void TskProcess( pTsk ) 
PTSK pTsk; 

TskAssert( pTsk ); 



r Set up a second exception handler for special errors V 

if ( TskOnException( pTsk ) ) { 
r If an exception occurs, program control will jump to V 
r this IF statement. The code within this IF statement */ 
r will be used to report the exception V 



i* If control should be passed to higher level handler V 
return TskPropagateException( pTsk ); 



} ■ 
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TskPtrCond 



Summaty 

#include "cobjects.h' 
#lnclude "tskmac.h" 



ft 



Void 
PTSK 

Medlumint 



TskPtrCond( pTsk, error ) 

pTsk; 

error; 



Public Ftmctlon 

This function is only available as a macro 



Purpose 



The TskPtrCond function checks the condition flag error and raises an 
exception if error is zero for the Task pTsk. The condition type 
EXTVALID.PTR, the file name flleName and the line number in the file lineNo 
are passed to the fimction. 

The TskPtrCond is used throughout C+O to check for illegal pointer values 
before attempting to execute the function. The production libraries turn off 
most precondition checking. 

TskPtrCond is most frequently used as part of the class pointer asserts found 
in the header files for each class. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 

error - If error is equal to zero an exception is trigged. 

Return Value 

No return value 
Notes 

An exception handler must have been established prior to calling this function. 
Failure to do so results in program termination and a cryptic error message. 
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TskPtrCond 



See Also 

TskCondltion. TskLofiCond, TskPreCond. TskRaiseException, 
TskMalnLogCond, TskMainPreCond, TskMainPtrCond, 
TskMainRaiseException, TskOnException, TskPropagateE^ceptionHandler 

Example 

Please refer to class test procedure 

TST1.C.TST2,C,TST3.C,TST4.C.TST5.C.TST6.C for an example of the use of the 
TskPtrCond function. 
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TskRaiseException 



Summaty 

#include "cobjects.h" 
#lnclude "tskmac.h" 

Void TskRaiseException( pTsk, error ) 

PTSK pTsk: 
Mediumint error; 

Public Function 

This function Is only available as a macro 

Purpose 

The TskRaiseException function raises an exception unconditionally for tiie 
Task pTsk. The condition type EXr_FORCED, the file name fileName and tiie 
line number in the file lineNo are passed to the function. The signal error can 
be retrieved by the exception handler. 

TskRaiseException can be used to signal special conditions to an exception 
handler. 

Parameter - Description 



pTsk - Pointer to a structure of type Task. 
error - The signal value. 

Return Value 

No return vEdue 

Notes 

An exception handler must have been established prior to calling this function. 
Failure to do so results in program termination and a cryptic error message. 

See Also 

TskCondition. TskLogCond. TskPreCond. TskPtrCond, TskMainLogCond, 
TskMainPreCond, TskMalnPtrCond, TskMalnRaiseException, TskOnException, 
TskPropagateExceptionHandler 
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TskRaiseException 



Example 

Please refer to class test procedure 

TST1.C,TST2.C.TST3.C,TST4.C.TST5.C,TST6.C for an example of the use of the 
TskRaiseException function. 
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Task 
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Class Reference for Vertex 



Structure Name: 
Abbreviation: 
Class Type: 



Vertex 
Vtx 

Inheritable class 



VtxAsGrfLel 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

PLEL VtxAsGrfLel(pVtx) 
PVTX pVtx; 

Friend Function 

A macro is available for this function 

Purpose 

The VtxAsGrfLel function returns a pointer to the ListElement structure 
contained by the Vertex pVtx for linking to the graph. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 
Return Value 

The return value from the VtxAsGrfLel function is a pointer to the UstElement 
structure contained by the Vertex pVtx. 

See Aiso 

VtxAsInDU. VtxAsObJ, VtxAsOutDll 

Exampie 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxAsGrfLel function. 
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VtxAslnDII 



Summary 

#lnclude "cobjects.h" 
#lnclude "vtxmach" 

POLL VtxAsInDlKpVtx) 
PVTX pVtx: 

Friend Function 

Purpose 

Hie return value from the VtxAslnDII function is a pointer to the List structure 
contained by the Vertex pVtx. The list contains the incoming edges to pVtx. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

The return value from the VtxAslnDII function is a pointer to the structure of 
type List contained by the Vertex class. The list contains the incoming edges to 
pVtx. 

See Also 

VtxAsGrfLel. VtxAsObj. Vt?cAsOutDll 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxAsInDU function. 
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VtxAsObj 



Summary 

#include "cobjects.h' 
#include "vtxmac.h" 



POBJ 
PVTX 



VtxAsObj(pVtx) 
pVtx; 



Private Function 



Purpose 



The VtxAsObJ function returns a pointer to the Object structure contained by 
the Vertex pVtx. 

Parameter - Description 



Return Value 

The return value from the VtxAsObj ftinction is a pointer to the Object 
structure contained by the Vertex class. 



The Object pointer can be used to send a message to the client of the vertex. 

See Also 

VtxAsGrfLel, VtxAsInDll. VtxAsOutDU 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxAsObj function. 



pVtx 



Pointer to a structure of type Vertex. 



Notes 
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VtxAsOutDII 



Summary 

#lnclude "cobjects.h' 
#include "vtxmac.h" 



POLL 
PVTX 



VtxAsOutDU(pVtx) 
pVtx; 



Friend Function 



Purpose 



The return value from the VtxAsOutDII function is a pointer to the List 
structure contained by the Vertex pVtx. The list contains the outgoing edges to 
pVtx. 



Return Value 

The return value from the VtxAsOutDII function is a pointer to the structure of 
type List contained by the Vertex class. The list contains the outgoing edges to 
pVtx. 

See Also 

VtxAsGrfLel. VtxAsInDll, VtxAsObj 



Please refer to class test procedure TSTGRF.C for an example of the use of the 
Vt?cAsOutDll frmction. 



Parameter - Description 



pVtx 



Pointer to a structure of type Vertex. 



Example 
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VtxClear 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Void Vtxaear(pVtx) 
PVTX pVtx; 

Public Function 

Purpose 

The VtxClear function unlinks the edges (if any) from the Vertex pVtx and also 
unlinks pVtx from the graph. The vertex will be in the same state as it was 
after being initialized. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

No return '\^ue 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxClear function. 
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VtxConnectToGrf 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Void VtxConnectToGrf(pVtx,pGrf) 

PVTX pVtx; 
PGRF pGrf; 

Public Function 

Purpose 

The VtxConnectToGrf links the Vertex pVtx to the Graph pGrf. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 
pGrf - Pointer to the Graph structure that the vertex will be 
linked to. 

Return Value 

No return value 

Notes 

IpVtx must not already be linked to a graph.] 
[pVtx must have no edges.] 

See Also 

VtxDisconnectFromGrf 
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VtxConnectToGrf 



Diagram 
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Vertex to Connect 
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VtxCountIn 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Mediumint VtxCoimtIn( p Vtx ) 
PVTX pVtx: 

Public Function 

A macro Is available for this function 

Purpose 

The VtxCountIn function returns the number of Incoming edges that are linked 
to the Vertex pVtK. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

The return value from the VtxCountIn function is the number of incoming 
edges to the Vertex pVtx. 

See Also 

VtxCountOut 



Vtx-9 



VtxCountIn 



Diagram 

Incoming Edges = 3 




Legend 
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VtxCountOut 



Summary 

#include "cobjects.h" 
#lnclude "vtxmac.h" 

Mediumlnt VtxCountOuK pVtx ) 
PVTX pVtx; 

Public Function 

A niacro is available for this function 

Putpose 

The VtxCountOut function returns the number of outgoing edges that are 
linked to the VeiteicpVtx. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 
Return Value 

The return value from the VtxCountOut function is the nimiber of outgoing 
edges from the Vertex pVtx. 

See Also 

VtxCountIn 
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VtxCountOut 



Diagram 

Outgoing Edges = 2 




Legend 
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VtxDelnit 



Summary 

#include "cobjects.h' 
#include "vtxmach" 



Void 
PVTX 



VtxDeInit(pVtx) 

pVtx; 



Public Function 



Purpose 



The VtxDelnit function deinitializes the Vertex object. The VtxDelnit fianction 
should be the last function called when using the Vertex class. 

Parameter - Description 



Return Value 

No return value 

Notes 

The first function to call when using the Vertex class is Vtxinit. 

pVtx can be unlinked from its edges and the graph using the VtxClear 
function. 

IpVtx must have no edges.] 

(pVtx must not already be linked to a graph.] 

See Also 

VtxDestroy, Vtjdnit 



Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxDelnit function. 



pVtx 



Pointer to a structure of type Vertex. 



Example 
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VtxDestroy 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Void VtxDestroy( pVtx ) 

PVTX pVtx; 

Public FtmctJon 

Purpose 

The VtxDestroy function deallocates the memory used by the object and 
delnitializes the Vertex object. The Vertex pVtx should not be referenced after 
this function call since its memory will have been deallocated. 

Any vertices linked to pVtx will be tmlinked and pVtx will also be unlinked 
from its graph. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

No return value 

Notes 

IpVtx must not have a sub-object.] 

See Also 

VtxDelnit, Vtxinit 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxDestroy function. 
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VtxDisconnectFromGrf 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Void VtxDisconnectFroinGrf( pVtx ) 

PVTX pVtx; 

Public Function 

A macro Is available for this function 

Purpose 

The VtxDisconnectFromGrf function unlinks the Vertex pVtx from a Graph. The 
vertex must not have any linkage to edges. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

No return value 

Notes 

[pVtx must be linked to a graph.] 
[pVtx must have no edges.] 

See Also 

VtxConnectToGrf 
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VtxDIsconnectFromGrf 



Diagram 
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VtxFlndOutEdg 



Summary 

#include "cobjects.h" 
#include 'Vtxmac.h" 



PEDG VtxFindOutEdg( pVtxO, pVtxI, offset pBlk ) 

PVTX pVtxO; 

PVTX pVtxI; 

Medlumint offset; 

PBLK pBlk; 



Private Function 

Purpose 

The VtxFindOutEdge function walks all the incoming edges linked to the Vertex 
pVtxI and returns me edge that has the Vertex pVtKO. as an outgoing edge. If 
no edge exists NULL is retumed. 

If the caller requires that the comparison should have additional criteria to 
linkage, an Edge client function can be given to call as the incoming edges are 
visited. If no function call is required a mnction NULL should be given. 

The Block pBlk contains the client function and an optional list of arguments. 
The function should retum a boolean (True/False) ^^ue. 

Parameter - Description 



pVtxO - Pointer to a structure of type Vertex where this vertex 

has the search edge as an outgoing edge. 
pVtxI - Pointer to a structure of type Vertex where this vertex 

has the search edge as an incoming edge, 
offset - The distance in bytes between an Edge and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The retum value from the VtxFindOutEdg function is a pointer to an Edge 
structure. The edge retumed is linked to the vertices pVtxI and pVtxO. If no 
edge is foimd then NULL is retumed. 
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VtxFindOutEdg 
Notes 

The function should return True for the VtJcFlndOutEdg function to return 
Ttue. 

The optional function ivill only be called if the edge links to the vertices pVtxI 
and pVtxO. 

See Also 

VtxFindOutEdgClient, EdgComparelnVtx 

Diagram 



Is pVtxO linked to my incoming Edge? 




Legend 
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VtxFindOutEdgClient 



Summary 

#lnclude "cobjects.li" 
#include 'Vtxmach" 



POBJ VtxFindOutEdgaienK pVtxO, pVtxI, offset, pBlk ) 

PVTX pVtxO: 

PVTX pvtxi: 

Mediumint offset; 

PBLK pBlk; 



Public Function 

Purpose 

The VtxFlndOutEdgeCllent function walks all the incoming edges linked to the 
Vertex pVtrf and returns the client of the edge that has the Vertex pVtxO, as an 
outgoing edge. If no edge exists NULL is returned. 

If the caller requires that the comparison should have additional criteria to 
linkage, an Edge client function can be given to call as the incoming edges are 
visited. If no function call is required a function NULL should be given. 

The Block pBlk contains the client function and an optional list of arguments. 
The function should retum a boolean (True/False) value. 

Parameter - Description 



pVtxO - Pointer to a structure of type Vertex where this vertex 

has the search edge as an outgoing edge. 
pVtxI - Pointer to a structure of type Vertex where this vertex 

has the search edge as an incoming edge, 
offset - The distance in bytes between an Edge and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The retum value from the VtxFindOutEdgClient function is a pointer to the 
Edge client structure for the edge that links to the vertices pVtxI and pVtxO. If 
no edge Is found then NULL is retumed. 
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VtxFindOutEdgClient 

Notes 

The client function should return True for the VtxFindOutEdgClient function to 
return True. 

The optional function will only be called if the edge links to the vertices pVbd 
and pVtxO. 

See Also 

VtxFindOutEdg, EdgComparelnVtx 

Diagram 

Is pVtxO linked to my incoming Edge? 




Legend 
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VtxGetClient 



Summary 

#include "cobjects.h" 
#lnclude "vtxmac.h" 

POBJ VtxGetaient( pVtx, offset ) 

PVTX pvtx: 

Mediumint offset; 
Public Function 

A macro Is available for this function 

Purpose 

The VtxGetClient function returns the client of the Vertex pVtx. 

Parameter - Description 



pVtx - Pointer to a structure of type Vertex. 
offset - Hie distance in bytes between the Vertex pVtx and it's 
client pointer. The value must be 0 or negative. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

The return value from the VtxGetClient function is a pointer to the client of the 
Vertex pVtx. 



Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxGetClient function. 
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VtxGetFirstIn 



Summary 

#include "cobjects.h" 
#include "vtxmach" 



PEDG 
PVTX 



VtxGetFirstIn( pVtx ) 
pVtx: 



Public Function 

A macro is available for this function 



Purpose 



The VtxGetFirstIn function returns the first incoming Edge linked to the Vertex 
pVtx or NULL If none exist. 



Return Value 

The return value from the VtxGetFirstIn function is a pointer to an Edge 
structure or NULL. This edge is the first in a list of incoming edges linked to 
the Vertex pVtx. 

See Also 

VtxGetFirstOut 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxGetFirstIn function. 



Parameter - Description 



pVts 



Pointer to a structure of type Vertex. 
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VtxGetFirstOut 



Summary 

#include "cobjects.h" 
#include "vtxmach" 

PEDG VtxGetFirstOuKpVtx) 
PVTX pVtx; 

Public Function 

A macro is available for this function 

Purpose 

The VtxGetFirstOut function returns the first outgoing Edge linked to the 
Vertex pVtx or NULL if none exist. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

The return value from the VtxGetFirstOut function is a pointer to an Edge 
structure or NULL. This edge is the first in a list of outgoing edges linked to the 
Vertex pVtx. 

See Also 

VtJcGetPirstIn 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxGetFirstOut fimction. 
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VtxGetGrf 



Summary 

#include "cobjects.h' 
#include "vtxmac.h" 



PGRF 
PVTX 



VtxGetGrf(pVtx) 

pVts: 



Friend Function 

A macro is avaUable for this function 



Purpose 



The VtxGetGrf function returns the a pointer to the graph that the Vertex pVtx 
is linked to. 



Return Value 

The return value from the VtxGetGrf function is a pointer to the Graph 
structure contained by the Vertex pVtx or NULL if not linked to a graph. 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxGetGrf function. 



Parameter - Description 



pVtx 



Pointer to a structure of type Vertex. 
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Vtxinit 



Summary 

#include "cobjects.h" 
#include "vtxmach" 

Void VtxIniKpVtx) 
PVTX pVtx: 

Public Function 

Purpose 

The Vtxinit function Initializes the Vertex object. The Vtxinit function should be 
the first function called when using the Vertex class. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

No return value 

Notes 

The last function to call when using the Vertex class is VtxDelnit. 
See Also 

VtxDelnit, VtxDestroy 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
Vtxinit function. 
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VtxInGrf 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 

Bool VtxInGrf(pVtx) 
PVTX pVtx; 

Public Function 

A macro Is available for this functi(m 

Purpose 

The VtxInGrf function determines if the Vertex pVtx is linked to a Grxtph. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

Return Value 

The return value from the VtxInGrf function is True if the Vertex pVtx is linked 
to a Grcq)K otherwise False if returned. 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxInGrf function. 



Vtx-26 



VtxSendDestroy 



Summary 

#include "cobjects.h' 
#lnclude "vtxmac.h" 



Void 
PVTX 




Public Function 



Purpose 



The VtxSendDestroy function sends a message to the client of the Vertex pVtx 
asking it to destroy the vertex. The Vertex client function wUl receive this 
message and should deinitialize or destroy the vertex. Hiis message function 
should be included in the Vertex client message array. 



Return Value 

No return value 

Example 

Please refer to class test procedure TSTGRF.C for an example of the use of the 
VtxSendDestroy function. 



Parameter - Description 



pVtx 



Pointer to a structure of type Vertex. 
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VtxStackSetup 



Summary 

#include "cobjects.h' 
#lnclude "vtxmac.h" 



Void 
PVTX 



VtxStackSctup( pVtx, inStack, outStack, stackVtx, i ) 

pVtx; 



Mediiimint 
Medlumint 
PVTX 



♦inStack: 
♦outStack; 
•stackVtx; 



Mediumlnt *i; 
Friend Function 

A macro Is available for this function 

Purpose 

The VtxStackSetup function is a private function used the Graph class. 

Return Value 

No return value 



This is a function only to be used by the Graph class and is used by the 
topological sort function. 



Example 

Please refer to class test procedure TSTGRF.C for an example of the use 
VtxStackSetup function. 



Notes 
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VtxVisitEdge 



Summary 

#lnclude "coLjects.h" 
#lnclude "vtxmac.h" 

Void VtxVisitEdge(pVtx,pBlk) 

PVTX pVtx; 
PBLK pBlk; 

Friend Function 

Purpose 

Hie VtxVisitEdge function walks all the edges linked to the Vertex pVtx and 
calls an Edge iunction for each edge visited. The Block pBlk contains the 
function and an optional list of arguments. 

Parameter - Description 

pVtx - Pointer to a structure of type Vertex. 

pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

Return Value 

No return value 

Notes 

The edge function may return a value but it is ignored. 

See Also 

VtxVisitEdgeCHent. VtxVisitlnEdge. VtxVisitlnEdgeClient. VtxVisitOutEdge. 
VtxVisitOutEdgeClient 
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VtxVisitEdge 



Diagram 



Walk all Edges 
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VtxVisitEdgeClient 



Summary 

#include "cobjects.h" 
#inclu(le "ytxmac.h" 

Void VtxVisitEdgeCUentC pVtx, effect, pBlk ) 

PVTX pvtx: 

Mediumlnt offset; 
PBLK pBlk; 

Public Function 

Purpose 

The VtxVisitEdgeClient function walks all the client edges linked to the Vertex 
pVtx and calls an Edge client function for each edge visited. The Block pBlk 
contains the client function and an optional list of arguments. 

Parameter - Description 



pVtx - Pointer to a structure of type Vertex. 

offset - The distance in bytes between an Edge and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Ckzss Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but it is ignored. 
See Also 

VtxVisitEdge, VtxVisitlnEdge. VtxVisitlnEdgeCUent, VtxVisitOutEdge, 
VtxVisitOutEdgeClient 
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VtxVisitEdgeClient 



Diagram 



Walk all Edges 
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VtxVisitlnEdge 



Summary 

#lnclude "cobjects.h" 
#include "vtxmac.h" 

Void VtxVisitInEdge( pVtx, pBlk ) 

PVTX pVtx; 
PBLK pBlk: 

Friend Function 

Purpose 

The VtxVisitlnEdge function walks all the incoming edges linked to the Vertex 
pVtx and calls an Edge function for each edge visited. Hie Block pBlk contains 
the function and an optional list of arguments. 

Parameter - Description 



pVtx - Pointer to a structure of type Vertex. 

pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

Return Value 

No return value 

Notes 

The edge function may return a value but it is ignored. 

See Also 

VtxVisitEdge, VtxVisitEdgeCUent, VtxVisitlnEdgeClient, VtxVisitOutEdge, 
VtxVisitOutEdgeClient 
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VtxV^sitlnEdge 



Diagram 



Walk Incoming Edges 
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VtxVisitlnEdgeClient 



Summary 

#include "cobjects.h" 
#include "vtxmac.h" 



Void VtxVisitInEdgeClient( pVtx, offset, pBlk ) 

PVTX pVtx; 

Mediumint offset; 

PBLK pBlk: 



Public Function 

Purpose 

The VtxVisitlnEdgeClient function walks all the incoming edges linked to the 
Vertex pVtx and calls an Edge client function for each edge visted. The Block 
pBlk contains the client function and an optional list of arguments. 

Parameter - Description 



pVtx - Pointer to a structure of type Vertex. 

offset - The distance in bytes between an Edge and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No retum value 

Notes 

The client function may retum a value but it is ignored. 

See Also 

VtxVisitEdge, VtxVlsitEdgeClient. VtxVisitlnEdge. VtxVisitOutEdge, 
VtxVisitOutEdgeCHent 
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VtxVisitlnEdgeClient 



Diagram 



Walk Incoming Edges 
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VtxVisitOutEdge 



Summary 

#include "cobjects.h' 
#lnclude "vtxmac.h" 



Void 

PVTX 
PBLK 



VtxVisilOutEdge( pVtx, pBlk ) 

pVtx; 

pBlk; 



Friend Function 



Purpose 



The VtxVisitOutEdge ftinction walks all the outgoing edges linked to the Vertex 
pVtx and calls an &jlge function for each edge visited. Tne Block pBlk contains 
the function and an optional list of arguments. 



Return Value 

No return value 
Notes 

The edge function may return a value but it is ignored. 

See Also 

VtxVisitEdge, VtxVisitEdgeCUent. VteVisitlnEdge. VtxVisitlnEdgeClient 
VtxVisitOutEdgeClient 



Parameter - Description 



pVtx 
pBlk 



Pointer to a structure of type Vertex. 
Pointer to structure of type Block which contains the 
client function to call and any optional parameters to 
be sent to the function. 
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VtxVisitOutEdge 



Diagram 



Walk outgoing Edges 
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VtxVisitOutEdgeClient 



Summary 

#lnclude "cobjects.h" 
#include "vtxmac.h" 

Void VtxVisitOutEdgcaientC pVtx, offset, pBlk ) 

PVTX pVtx; 
Mediumint offset; 
PBLK pBlk: 

Public Function 

Purpose 

The VtxVisitOutEdgeClient function walks all the outgoing edges linked to the 
Vertex pVtx and calls an Edge client function for each edge visited. The Block 
pBlk contains the client function £ind an optional list of arguments. 

Parameter - Description 



pVtx - Pointer to a structure of type Vertex. 

offset - The distance in bytes between an Edge and it's client 

pointer. The value must be 0 or negative. 
pBlk - Pointer to structure of type Block which contains the 

client function to call and any optional parameters to 

be sent to the function. 

offset: See the Class Data Structures reference guide for details on using 
offsets. 

Return Value 

No return value 

Notes 

The client function may return a value but It is ignored. 

See Also 

VtxVisitEdge. VtxVisitEdgeClient, VtxVisitlnEdge, VtxVisitlnEdgeCUent, 
VtxVisitOutEdge 
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VtxVisitOutEdgeClient 



Diagram 

Walk outgoing Edges 
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